The conda configuration file (.condarc)

The conda configuration file (.condarc) is an OPTIONAL runtime configuration file which allows advanced users to configure various aspects of conda, such as which channels it searches for packages, proxy settings, environment directories, etc.

A .condarc file is not included by default, but it is automatically created in the user’s home directory the first time you run the conda config command.

A .condarc file may also be located in the root environment, in which case it overrides any in the home directory.

Note: A .condarc file can also be used in an administrator-controlled installation to override the users’ configuration. Please see Centralized installation.

The conda configuration file can be used to change:

  • Where conda looks for packages
  • If and how conda uses a proxy server
  • Where conda lists known environments
  • Whether to update the bash prompt with the current activated environment name
  • Whether user-built packages should be uploaded to
  • Default packages or features to include in new environments
  • And more.

To create or modify a .condarc configuration file, from the command line, use the conda config command, or use a text editor to create a new file named .condarc and save to your user home directory or root directory.


conda config --add channels r

SEE ALSO: For a complete list of conda config commands available, see the command reference. The same list is available at the command prompt by typing conda config --help.

The .condarc configuration file follows simple YAML syntax.

Download a sample .condarc file to edit in your editor and save to your user home directory or root directory.

TIP: Conda supports tab completion with external packages instead of internal configuration.

For more configuration information see:

General configuration

Channel locations (channels)

Listing channel locations in the .condarc file will override conda defaults, causing conda to search only the channels listed here, in the order given.

Use defaults to automatically include all default channels. Non-url channels will be interpreted as usernames, and this can be changed by modifying the channel_alias key as explained below. The default is just defaults.

  - <anaconda_dot_org_username>
  - http://some.custom/channel
  - file:///some/local/directory
  - defaults

To select channels for a single environment, put a .condarc file in the root directory of that environment. If you have installed Miniconda with Python 3 in your home directory and the environment is named “flowers”, the path may be ~/miniconda3/envs/flowers/.condarc, and for other conda installations the path will be similar.

Update conda automatically (auto_update_conda)

When True, conda updates itself any time a user updates or installs a package in the root environment. When False, conda updates itself only if the user manually issues a conda update command. The default is True. You can edit the .condarc file or set the option with a command such as conda config --set auto_update_conda False.

auto_update_conda: False

Always yes (always_yes)

Choose the yes option whenever asked to proceed, such as when installing. Same as using the --yes flag at the command line. The default is False.

always_yes: True

Show Channel URLs (show_channel_urls)

Show channel URLs when displaying what is going to be downloaded and in conda list. The default is False.

show_channel_urls: True

Change command prompt (changeps1)

When using activate, change the command prompt ($PS1) to include the activated environment. The default is True.

changeps1: False

Add PIP as Python Dependency (add_pip_as_python_depedency)

Add pip, wheel and setuptools as dependencies of python. This ensures pip, wheel and setuptools will always be installed any time python is installed. The default is True.

add_pip_as_python_dependency: False

Use PIP (use_pip)

Use pip when listing packages with conda list. Note that this does not affect any conda command or functionality other than the output of the command conda list. The default is True.

use_pip: False

Configure conda for use behind a proxy server (proxy_servers)

By default, proxy settings are pulled from the HTTP_PROXY and HTTPS_PROXY environment variables or the system. Setting them here overrides that default.

    http: http://user:[email protected]:8080
    https: https://user:[email protected]:8080

To give a proxy for a specific scheme and host, use the scheme://hostname form for the key. This will match for any request to the given scheme and exact hostname.

  '': ''

Note: If you do not include the username and password, of if authentication fails, conda will prompt for a username and password.

Note: If your password contains special characters they will need to be escaped as follows:

Note: Be careful not to use http when you mean https, or https when you mean http.

Note: If you are behind a proxy that does SSL inspection such as a Cisco IronPort Web Security Appliance (WSA), it may be necessary to override the SSL verification settings using ssl_verify as described in SSL verification (ssl_verify).

Offline mode only (offline)

Filters out all channels URLs which do not use the file:// protocol. The default is False.

offline: True

Advanced configuration

Set a channel alias (channel_alias)

By default, conda install --channel asmeurer <package> is the same as conda install --channel <package>. This is because the default channel_alias is . Whenever conda is given a channel name that is not a URL, it prepends the channel_alias to the front of the name it was given.

You can set the channel_alias to your own repository. If your repository is at then conda install --channel jsmith <package> would be the same as conda install --channel <package> .

channel_alias: https://your.repo/

NOTE: For Windows users, the slash (/) at the end of a URL is required. Example https://your.repo/conda/

Always add packages by default (create_default_packages)

When creating new environments add these packages by default. You can override this option at the command prompt with the --no-default-packages flag. The default is not to include any packages.

  - ipython

Track features (track_features)

Enable certain features to be tracked by default. The default is to not track any features. This is similar to adding mkl to the create_default_packages list.

  - mkl

Disable updating of dependencies (update_dependencies)

By default, conda install updates the given package and all its dependencies to the latest versions.

If you prefer to only update the packages given explicitly at the command line and avoid updating existing installed packages as much as possible, you can set update_dependencies to True.

update_dependencies: True

Note that conda will still ensure that dependency specifications are satisfied, so some dependencies may still be updated, or, conversely, this may prevent packages given at the command line from being updated to their latest versions. You can always specify versions at the command line to force conda to install a given version (like conda install numpy=1.9.3).

This option can also be enabled or disabled at the command line with the --update-dependencies and --no-update-dependencies flags.

To avoid updating only specific packages in an environment, a better option may be to pin them. See Pinning packages for more information.

Conda build configuration

Automatically upload conda build packages to (anaconda_upload)

Automatically upload packages built with conda build to The default is False.

anaconda_upload: True

Specify conda build output root directory (conda-build)

Build output root directory. This can also be set with the CONDA_BLD_PATH environment variable. The default is <CONDA_PREFIX>/conda-bld/, or if you do not have write permissions to <CONDA_PREFIX>/conda-bld/ , ~/conda-bld/ .

    root-dir: ~/conda-builds