conda config

Modify configuration values in .condarc.

This is modeled after the git config command. Writes to the user .condarc file (/home/docs/.condarc) by default. Use the --show-sources flag to display all identified configuration locations on your computer.

usage: conda config [-h] [--json] [--console CONSOLE] [-v] [-q]
                    [--system | --env | --file FILE] [--show [SHOW ...] |
                    --show-sources | --validate | --describe [DESCRIBE ...] |
                    --write-default] [--get [KEY ...] | --append KEY VALUE |
                    --prepend KEY VALUE | --set KEY VALUE | --remove KEY VALUE
                    | --remove-key KEY | --stdin]

Output, Prompt, and Flow Control Options

--json

Report all output as json. Suitable for using conda programmatically.

--console

Select the backend to use for normal output rendering.

-v, --verbose

Can be used multiple times. Once for detailed output, twice for INFO logging, thrice for DEBUG logging, four times for TRACE logging.

-q, --quiet

Do not display progress bar.

Config File Location Selection

Without one of these flags, the user config file at '/home/docs/.condarc' is used.

--system

Write to the system .condarc file at '/home/docs/checkouts/readthedocs.org/user_builds/continuumio-conda/envs/latest/.condarc'.

--env

Write to the active conda environment .condarc file (<no active environment>). If no environment is active, write to the user config file (/home/docs/.condarc).

--file

Write to the given file.

Config Subcommands

--show

Display configuration values as calculated and compiled. If no arguments given, show information for all configuration values.

--show-sources

Display all identified configuration sources.

--validate

Validate all configuration sources. Iterates over all .condarc files and checks for parsing errors.

--describe

Describe given configuration parameters. If no arguments given, show information for all configuration parameters.

--write-default

Write the default configuration to a file. Equivalent to conda config --describe > ~/.condarc.

Config Modifiers

--get

Get a configuration value.

--append

Add one configuration value to the end of a list key.

--prepend, --add

Add one configuration value to the beginning of a list key.

--set

Set a boolean or string key.

--remove

Remove a configuration value from a list key.

This removes all instances of the value.

--remove-key

Remove a configuration key (and all its values).

--stdin

Apply configuration information given in yaml format piped through stdin.

See conda config --describe or https://conda.io/docs/config.html for details on all the options that can go in .condarc.

Examples:

Display all configuration values as calculated and compiled:

conda config --show

Display all identified configuration sources:

conda config --show-sources

Print the descriptions of all available configuration options to your command line:

conda config --describe

Print the description for the "channel_priority" configuration option to your command line:

conda config --describe channel_priority

Add the conda-canary channel:

conda config --add channels conda-canary

Set the output verbosity to level 3 (highest) for the current activate environment:

conda config --set verbosity 3 --env

Add the 'conda-forge' channel as a backup to 'defaults':

conda config --append channels conda-forge