Merge pull request conda#9369 from rrigdon/search-condarc

Added info on searching for .condarc
Arrowbox · Oct 25, 2019 · d1c7a5d · d1c7a5d
2 parents f39a6fd + d18aa6d
commit d1c7a5d
Showing 1 changed file with 40 additions and 0 deletions.
diff --git a/docs/source/user-guide/configuration/use-condarc.rst b/docs/source/user-guide/configuration/use-condarc.rst
@@ -101,6 +101,46 @@ gives a non-exhaustive list of the most frequently used options and
 their usage. For a complete list of all available options for your
 version of conda, use the ``conda config --describe`` command.
 
+Searching for .condarc
+======================
+
+Conda looks in the following locations for a ``.condarc`` file:
+
+.. code-block:: python
+
+    if on_win:
+     SEARCH_PATH = (
+         'C:/ProgramData/conda/.condarc',
+         'C:/ProgramData/conda/condarc',
+         'C:/ProgramData/conda/condarc.d',
+     )
+     else:
+     SEARCH_PATH = (
+         '/etc/conda/.condarc',
+         '/etc/conda/condarc',
+         '/etc/conda/condarc.d/',
+         '/var/lib/conda/.condarc',
+         '/var/lib/conda/condarc',
+         '/var/lib/conda/condarc.d/',
+      )
+
+     SEARCH_PATH += (
+         '$CONDA_ROOT/.condarc',
+         '$CONDA_ROOT/condarc',
+         '$CONDA_ROOT/condarc.d/',
+         '~/.conda/.condarc',
+         '~/.conda/condarc',
+         '~/.conda/condarc.d/',
+         '~/.condarc',
+         '$CONDA_PREFIX/.condarc',
+         '$CONDA_PREFIX/condarc',
+         '$CONDA_PREFIX/condarc.d/',
+         '$CONDARC',
+     )
+
+``CONDA_ROOT`` is the path for your base conda install.
+``CONDA_PREFIX`` is the path to the current active environment.
+
 
 General configuration
 =====================