conan config

$ conan config [-h] {rm,set,get,install} ...

Manages Conan configuration. Edits the conan.conf or installs config files.

positional arguments:
  {rm,set,get,install}  sub-command help
    rm                  Remove an existing config element
    set                 Set a value for a configuration item
    get                 Get the value of configuration item
    install             install a full configuration from a local or remote
                        zip file

optional arguments:
  -h, --help            show this help message and exit


  • Change the logging level to 10:

    $ conan config set log.level=10
  • Get the logging level:

    $ conan config get log.level
    $> 10

conan config install

The config install is intended to share the Conan client configuration. For example, in a company or organization, is important to have common settings.yml, profiles, etc.

It retrieves a zip file from a local directory or url and apply the files in the local Conan configuration.

The zip can contain only a subset of all the allowed configuration files, only the present files will be replaced, except the conan.conf file, that will apply only the declared variables in the zipped conan.conf file and will keep the rest of the local variables.

The profiles files, that will be overwritten if already present, but won’t delete any other profile file that the user has in the local machine.

All files in the zip will be copied to the conan home directory. These are the special files and the rules applied to merge them:


How it is applied


Overrides the local ~/.conan/profiles/MyProfile if already exists


Overrides the local ~/.conan/settings.yml


Overrides remotes. Will remove remotes that are not present in file


Merges the variables, overriding only the declared variables

The file remotes.txt is the only file listed above which does not have a direct counterpart in the ~/.conan folder. Its format is a list of entries, one on each line, with the form

[remote name] [remote url] [bool]

where [bool] (either True or False) indicates whether SSL should be used to verify that remote.

The local cache registry.txt file contains the remotes definitions, as well as the mapping from packages to remotes. In general it is not a good idea to add it to the installed files. That being said, the remote definitions part of the registry.txt file uses the format required for remotes.txt, so you may find it provides a helpful starting point when writing a remotes.txt to be packaged in a Conan client configuration.

The specified URL will be stored in the general.config_install variable of the conan.conf file, so following calls to conan config install command doesn’t need to specify the URL.


  • Install the configuration from a URL:

    $ conan config install http://url/to/some/

    Conan config command stores the specified URL in the conan.conf general.config_install variable.

  • Install the configuration from a Git repository:

    $ conan config install

    You can also force the git download by using --type git (in case it is not deduced from the URL automatically):

    $ conan config install --type git
  • Install from a URL skipping SSL verification:

    $ conan config install http://url/to/some/ --verify-ssl=False

    This will disable the SSL check of the certificate. This option is defaulted to True.

  • Refresh the configuration again:

    $ conan config install

    It’s not needed to specify the url again, it is already stored.

  • Install the configuration from a local path:

    $ conan config install /path/to/some/