conan remote
$ conan remote [-h]
{list,add,remove,update,rename,list_ref,add_ref,remove_ref,update_ref,list_pref,add_pref,remove_pref,update_pref,clean,enable,disable}
...
Manages the remote list and the package recipes associated with a remote.
positional arguments:
{list,add,remove,update,rename,list_ref,add_ref,remove_ref,update_ref,list_pref,add_pref,remove_pref,update_pref,clean,enable,disable}
sub-command help
list List current remotes
add Add a remote
remove Remove a remote
update Update the remote url
rename Update the remote name
list_ref List the package recipes and its associated remotes
add_ref Associate a recipe's reference to a remote
remove_ref Dissociate a recipe's reference and its remote
update_ref Update the remote associated with a package recipe
list_pref List the package binaries and its associated remotes
add_pref Associate a package reference to a remote
remove_pref Dissociate a package's reference and its remote
update_pref Update the remote associated with a binary package
clean Clean the list of remotes and all recipe-remote
associations
enable Enable a remote
disable Disable a remote
optional arguments:
-h, --help show this help message and exit
Examples
List remotes:
$ conan remote list conancenter: https://center.conan.io [Verify SSL: True] local: http://localhost:9300 [Verify SSL: True, Disabled: True]
List remotes in a format almost valid for the remotes.txt to use with conan config install, only need to remove the
True
boolean appended to disabled remotes (notice line forlocal
one in the output):$ conan remote list --raw conancenter https://center.conan.io True local http://localhost:9300 True True # capture the current remotes in a text file $ conan remote list --raw > remotes.txt
Add a new remote:
$ conan remote add remote_name remote_url [verify_ssl]
Verify SSL option can be True or False (defaulted to True). Conan client will verify the SSL certificates.
Insert a new remote:
Insert as the first one (position/index 0), so it is the first one to be checked:
$ conan remote add remote_name remote_url [verify_ssl] --insert
Insert as the second one (position/index 1), so it is the second one to be checked:
$ conan remote add remote_name remote_url [verify_ssl] --insert=1
Add or insert a remote:
Adding the --force
argument to conan remote add
will always work, and won’t raise an error.
If an existing remote exists with that remote name or URL, it will be updated with the new information.
The --insert
works the same. If not specified, the remote will be appended the last one. If specified,
the command will insert the remote in the specified position
$ conan remote add remote_name remote_url [verify_ssl] --force --insert=1
Remove a remote:
$ conan remote remove remote_name
Remove all configured remotes (this will also remove all recipe-remote associations):
$ conan remote clean
Update a remote:
$ conan remote update remote_name new_url [verify_ssl]
Rename a remote:
$ conan remote rename remote_name new_remote_name
Change an existing remote to the first position:
$ conan remote update remote_name same_url --insert 0
List the package recipes and its associated remotes:
$ conan remote list_ref bzip2/1.0.6@lasote/stable: conan.io Boost/1.60.0@lasote/stable: conan.io zlib/1.2.8@lasote/stable: conan.io
In some cases you may want to list the packages that are not associated with any remote:
$ conan remote list_ref --no-remote spdlog/1.8.0: None restinio/0.6.10: None opencv/2.4.13.7: None
Also, you can list the remote association for different binaries of the same Conan package:
$ conan remote list_pref zlib/1.2.8@ zlib/1.2.8:f83037eff23ab3a94190d7f3f7b37a2d6d522241: conancenter zlib/1.2.8:e46341e9b52d3e4c66657dc8fb13ab6cdd5831c6: conan-local-dev zlib/1.2.8:9de3196f2439d69299f168e3088bbefafe212f38: conan-local-prod
If you want to know if any binaries of a Conan package have no remote association:
$ conan remote list_pref zlib/1.2.8@ --no-remote zlib/1.2.8:a7480322bf53ca215dbba4db77ee500c7c51ee33: None
Associate a recipe’s reference to a remote:
$ conan remote add_ref openssl/1.0.2u conancenter
Update the remote associated with a package recipe:
$ conan remote update_ref openssl/1.0.2t local-remote
Enable or disable remotes (accepts patterns such as
*
as argument using Unix shell-style wildcards):$ conan remote disable "*" $ conan remote enable local-remote
Note
Check the section How to manage SSL (TLS) certificates section to know more about server certificates verification and client certifications management .