Skip to content

Commit 1125d36

Browse files
add some warnings and info to mamba installation
1 parent 225a734 commit 1125d36

File tree

1 file changed

+14
-4
lines changed

1 file changed

+14
-4
lines changed

doc/getting-started/install.rst

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,13 +24,23 @@ Prerequisites
2424
* Ensure a **stable internet connection** for the installation procedure.
2525
All dependencies will be downloaded from the internet.
2626
Do **not** use a metered, mobile connection!
27-
* Install the `Conda`_ environment management system.
28-
We highly recommend you use `Miniforge`_, which includes the potent `Mamba`_ package manager.
29-
Download the installer suitable for your system and follow the respective installation instructions.
30-
We do **not** recommend using the ``conda`` command anymore, rather use ``mamba`` (see :ref:`conda-instead-of-mamba`).
3127

3228
.. note:: When mentioning the terms "terminal" or "command line" in the following, we are referring to the "Terminal" apps on macOS or Linux and the "Miniforge Prompt" on Windows.
3329

30+
Install Mamba or Conda
31+
^^^^^^^^^^^^^^^^^^^^^^^^^^^
32+
33+
If you haven't already installed an environment management system like `Mamba`_ or `Conda`_, you have to do so now.
34+
We recommend to use ``mamba`` (see :ref:`conda-instead-of-mamba`) which is available in the installer Miniforge.
35+
36+
For the installation of Miniforge, plase scroll to the **Install** section of `Miniforge`_ and follow the respective installation instructions for your OS.
37+
38+
.. attention:: After accepting the license terms and confirming the location, you are asked if you wish to update yor shell profile to automatically initialize conda. **Do not just hit ENTER but first type the choice 'yes'**.
39+
40+
.. note:: If you later encounter ``command not found: conda``, open a new terminal window.
41+
42+
.. note:: If you later encounter ``Run 'mamba init' to be able to run mamba activate/deactivate and start a new shell session. Or use conda to activate/deactivate.`, please run ``mamba init`` or ``mamba init zsh``.
43+
3444
.. _install-choice:
3545

3646
Decide on Your Entry Level!

0 commit comments

Comments
 (0)