diff --git a/docs/source/install/dependencies.rst b/docs/source/install/dependencies.rst index ec1fd0259..0ca46a4cd 100644 --- a/docs/source/install/dependencies.rst +++ b/docs/source/install/dependencies.rst @@ -45,27 +45,26 @@ For all other systems, we recommend to use a **package dependency manager**: Pick *one* of the installation methods below to install all dependencies for ImpactX development in a consistent manner. -Conda (Linux/macOS/Windows) ---------------------------- +Conda-Forge (Linux/macOS/Windows) +--------------------------------- -`Conda `__/`Mamba `__ are cross-compatible, user-level package managers. +`Conda-Forge `__ is a repository for cross-compatible, user-level packages. .. tip:: - We recommend to configure your conda to use the faster ``libmamba`` `dependency solver `__. + We recommend to deactivate that conda self-activates its ``base`` environment. + This `avoids interference with the system and other package managers `__. .. code-block:: bash - conda update -y -n base conda - conda install -y -n base conda-libmamba-solver - conda config --set solver libmamba + conda config --set auto_activate_base false - We recommend to deactivate that conda self-activates its ``base`` environment. - This `avoids interference with the system and other package managers `__. + In order to make sure that the conda configuration uses ``conda-forge`` as the only channel, which will help avoid issues with blocked ``defaults`` or ``anaconda`` repositories, please set the following configurations: .. code-block:: bash - conda config --set auto_activate_base false + conda config --add channels conda-forge + conda config --set channel_priority strict .. tab-set:: diff --git a/docs/source/install/users.rst b/docs/source/install/users.rst index 401ada0ee..6d59b4cc6 100644 --- a/docs/source/install/users.rst +++ b/docs/source/install/users.rst @@ -37,36 +37,35 @@ If want to use ImpactX on a specific high-performance computing (HPC) systems, j .. image:: conda.svg -Using the Conda Package ------------------------ +Using the Conda-Forge Package +----------------------------- -A package for ImpactX is available via the `Conda `_ package manager. +A package for ImpactX is available via `Conda-Forge `__. .. tip:: - We recommend to configure your conda to use the faster ``libmamba`` `dependency solver `__. + We recommend to deactivate that conda self-activates its ``base`` environment. + This `avoids interference with the system and other package managers `__. .. code-block:: bash - conda update -y -n base conda - conda install -y -n base conda-libmamba-solver - conda config --set solver libmamba + conda config --set auto_activate_base false - We recommend to deactivate that conda self-activates its ``base`` environment. - This `avoids interference with the system and other package managers `__. + In order to make sure that the conda configuration uses ``conda-forge`` as the only channel, which will help avoid issues with blocked ``defaults`` or ``anaconda`` repositories, please set the following configurations: .. code-block:: bash - conda config --set auto_activate_base false + conda config --add channels conda-forge + conda config --set channel_priority strict .. code-block:: bash - conda create -n impactx -c conda-forge impactx - conda activate impactx + mamba create -n impactx -c conda-forge impactx + mamba activate impactx .. note:: - The ``impactx`` `conda package `__ does not yet provide GPU support. + The ``impactx`` package on conda-forge does not yet provide `GPU support `__. .. _install-spack: