Install from conda-forge - Installation Guide

Skip to content
Back to top
View this page
Edit this page

# Install from conda-forge

SageMath can be installed on Linux and macOS via Conda from the conda-forge conda channel.

Both the `x86_64` (Intel) architecture and the `arm64`/`aarch64` architectures (including Apple Silicon, M1, M2, M3, M4) are supported.

You will need a working Conda installation: either Miniforge, Miniconda or Anaconda. If you don’t have one yet, we recommend installing Miniforge as follows. In a terminal,

    $ curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
    $ bash Miniforge3-$(uname)-$(uname -m).sh

After installing Conda, you will need to either start a new terminal session, or run

    $ source ~/.bashrc

Instead of \(bashrc\) you might need to use \(zshrc\) (usual on macOS), or whatever shell name you are using. It should be clear from the messages at the end of the Conda installer run.

- Miniforge uses conda-forge as the default channel. However, if you are using Miniconda or Anaconda, set it up to use conda-forge:

  - Add the conda-forge channel: `conda config --add channels conda-forge`

  - Change channel priority to strict: `conda config --set channel_priority strict`

If you installed Miniforge (or Mambaforge), we recommend to use mamba in the following, which uses a faster dependency solver than `conda`.

## Installing all of SageMath from conda (not for development)

Create a new conda environment containing SageMath, either with `mamba` or `conda`:

mamba

    $ mamba create -n sage sage

conda

    $ conda create -n sage sage

To use Sage from there,

- Enter the new environment: `conda activate sage`

- Start SageMath: `sage`

If there are any installation failures, please report them to the conda-forge maintainers by opening a GitHub Issue for conda-forge/sage-feedstock.