Skip to content

Commit 40de356

Browse files
authored
Update Conda installation instructions to use Miniforge
1 parent e417e22 commit 40de356

File tree

1 file changed

+30
-23
lines changed

1 file changed

+30
-23
lines changed

src/doc/en/installation/conda.rst

Lines changed: 30 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -9,32 +9,27 @@ SageMath can be installed on Linux and macOS via Conda from the
99
Both the ``x86_64`` (Intel) architecture and the ``arm64``/``aarch64``
1010
architectures (including Apple Silicon, M1) are supported.
1111

12-
You will need a working Conda installation: either Mambaforge/Miniforge,
12+
You will need a working Conda installation: either Miniforge (or Mambaforge),
1313
Miniconda or Anaconda. If you don't have one yet, we recommend installing
14-
`Mambaforge <https://github.com/conda-forge/miniforge#mambaforge>`_ as
14+
`Miniforge <https://github.com/conda-forge/miniforge>`_ as
1515
follows. In a terminal,
1616

1717
.. code-block:: shell
1818
19-
$ curl -L -O https://github.com/conda-forge/miniforge/releases/latest/download/Mambaforge-$(uname)-$(uname -m).sh
20-
$ sh Mambaforge-$(uname)-$(uname -m).sh
19+
$ curl -L -O "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
20+
$ bash Miniforge3-$(uname)-$(uname -m).sh
2121
22-
* Mambaforge and Miniforge use conda-forge as the default channel.
22+
* Miniforge (and Mambaforge) use conda-forge as the default channel.
2323

2424
* If you are using Miniconda or Anaconda, set it up to use conda-forge:
2525

2626
* Add the conda-forge channel: ``conda config --add channels conda-forge``
2727

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

30-
Optionally, use `mamba <https://github.com/mamba-org/mamba>`_,
30+
If you installed Miniforge (or Mambaforge), we recommend to use
31+
`mamba <https://mamba.readthedocs.io/en/latest/index.html>`_ in the following,
3132
which uses a faster dependency solver than ``conda``.
32-
If you installed Mambaforge, it is already provided. Otherwise, use
33-
34-
.. code-block:: shell
35-
36-
$ conda install mamba
37-
3833

3934
.. _sec-installation-conda-binary:
4035

@@ -43,10 +38,17 @@ Installing all of SageMath from conda (not for development)
4338

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

46-
.. code-block:: shell
41+
.. tab:: mamba
42+
43+
.. code-block:: shell
4744
48-
$ mamba create -n sage sage python=X # either
49-
$ conda create -n sage sage python=X # or
45+
$ mamba create -n sage sage python=X
46+
47+
.. tab:: conda
48+
49+
.. code-block:: shell
50+
51+
$ conda create -n sage sage python=X
5052
5153
where ``X`` is version of Python, e.g. ``3.9``.
5254

@@ -109,17 +111,22 @@ Here we assume that you are using a git checkout.
109111

110112
$ export SAGE_NUM_THREADS=24
111113

112-
- As a recommended step, install the ``mamba`` package manager. If
113-
you skip this step, replace ``mamba`` by ``conda`` in the
114-
following steps::
115-
116-
$ conda install mamba
117-
118114
- Create and activate a new conda environment with the dependencies of Sage
119115
and a few additional developer tools::
120116

121-
$ mamba env create --file src/environment-dev-3.11-linux.yml --name sage-dev
122-
$ conda activate sage-dev
117+
.. tab:: mamba
118+
119+
.. code-block:: shell
120+
121+
$ mamba env create --file src/environment-dev-3.11-linux.yml --name sage-dev
122+
$ conda activate sage-dev
123+
124+
.. tab:: conda
125+
126+
.. code-block:: shell
127+
128+
$ conda env create --file src/environment-dev-3.11-linux.yml --name sage-dev
129+
$ conda activate sage-dev
123130

124131
Alternatively, you can use ``src/environment-3.11-linux.yml`` or
125132
``src/environment-optional-3.11-linux.yml``, which will only install standard

0 commit comments

Comments
 (0)