Skip to main content
The conda config command allows you to modify configuration values in conda’s configuration files (e.g., ~/.condarc). This command is modeled after the git config command and writes to the user .condarc file by default.

​
Syntax

conda config [options]

​
Config File Location Selection

By default, conda config writes to the user config file. You can specify a different location:

​
--system

Write to the system .condarc file.

​
--env

Write to the active conda environment .condarc file. If no environment is active, writes to the user config file.

​
--file FILE

Write to the specified file.

​
-p, --prefix PREFIX

Write to the .condarc file in the specified environment prefix.

​
-n, --name NAME

Write to the .condarc file in the named environment.

​
Config Subcommands

​
--show [KEY ...]

Display configuration values as calculated and compiled. If no arguments are given, shows information for all configuration values. 
# Show all configuration
conda config --show

# Show specific configuration keys
conda config --show channels
conda config --show channel_priority

​
--show-sources

Display all identified configuration sources and their values. 
conda config --show-sources

​
--validate

Validate all configuration sources. Iterates over all .condarc files and checks for parsing errors. 
conda config --validate

​
--describe [KEY ...]

Describe given configuration parameters. If no arguments are given, shows information for all configuration parameters. 
# Describe all configuration options
conda config --describe

# Describe specific configuration option
conda config --describe channel_priority

​
--write-default

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

​
Config Modifiers

​
--get [KEY ...]

Get a configuration value. 
conda config --get channels

​
--append KEY VALUE

Add one configuration value to the end of a list key. 
conda config --append channels conda-forge

​
--prepend KEY VALUE / --add KEY VALUE

Add one configuration value to the beginning of a list key. 
conda config --add channels conda-canary

​
--set KEY VALUE

Set a boolean or string key. 
# Set verbosity to highest level
conda config --set verbosity 3

# Set channel priority
conda config --set channel_priority strict

​
--remove KEY VALUE

Remove a configuration value from a list key. This removes all instances of the value. 
conda config --remove channels conda-forge

​
--remove-key KEY

Remove a configuration key (and all its values). 
conda config --remove-key channels

​
--stdin

Apply configuration information given in YAML format piped through stdin. 
echo "channels:\n  - defaults" | conda config --stdin

​
Options

​
--json

Report all output as JSON. Suitable for programmatic use.

​
Common Use Cases

​
Display all configuration

View your current conda configuration: 
conda config --show

​
Add a channel

Add the conda-forge channel as a backup to defaults: 
conda config --append channels conda-forge
The --add and --prepend flags add channels to the beginning of the list (highest priority), while --append adds them to the end (lowest priority).

​
Set verbosity for current environment

Set the output verbosity to level 3 (highest) for the current active environment: 
conda config --set verbosity 3 --env

​
View configuration sources

See where your configuration values are coming from: 
conda config --show-sources

​
Get help on configuration options

Print descriptions of all available configuration options: 
conda config --describe
Or get help on a specific option: 
conda config --describe channel_priority
Changes made with conda config take effect immediately but may not apply to already-running conda processes.

Build docs developers (and LLMs) love

Get started for freeTalk to us