conan remote
$ conan remote [-h]
{list,add,remove,update,rename,list_ref,add_ref,remove_ref,update_ref}
...
Manages the remote list and the package recipes associated to a remote.
positional arguments:
{list,add,remove,update,rename,list_ref,add_ref,remove_ref,update_ref}
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
optional arguments:
-h, --help show this help message and exit
Examples
List remotes:
$ conan remote list conan-center: https://conan.bintray.com [Verify SSL: True] local: http://localhost:9300 [Verify SSL: True]
List remotes in a format valid for remotes.txt (
conan config install
):$ conan remote list --raw conan-center https://conan.bintray.com True local http://localhost:9300 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 (default 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
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
Associate a recipe’s reference to a remote:
$ conan remote add_ref OpenSSL/1.0.2i@conan/stable conan-center
Update the remote associated with a package recipe:
$ conan remote update_ref OpenSSL/1.0.2i@conan/stable local-remote
Note
Check the section How to manage SSL (TLS) certificates section to know more about server certificates verification and client certifications management .