Conan Add Remote 〈HIGH-QUALITY〉
conan remote add command to link your Conan client to a new package repository (remote), such as an Artifactory instance or a private server. Conan Docs Core Command Syntax conan remote add
to place a new remote at a specific priority level. Remotes are checked in the order they are listed. Set as the first priority (index 0): conan remote add my-repo
to add a remote even if the name or URL already exists, effectively updating it. Disable/Enable
: Temporarily ignore a remote without removing it from your configuration. conan remote disable my-repo Use code with caution. Copied to clipboard Conan Docs Managing Authentication
Once added, you must often authenticate to upload or download private packages. Conan Docs
To add a remote to the Conan package manager, use the following command structure: conan remote add Use code with caution. Copied to clipboard Command Breakdown
: A unique name of your choice to identify the remote server (e.g., my-repo).
: The full URL of the server where the Conan packages are hosted. conan add remote
[verify_ssl]: (Optional) Set to True or False to enable or disable SSL certificate verification . It defaults to True if omitted . Management Commands
Check existing remotes: Use conan remote list to see all configured servers .
Set priority: Use the --insert flag to put a new remote at the top of the search list: conan remote add Use code with caution. Copied to clipboard
Authentication: After adding a remote, you may need to log in to access private packages using Conan's login command: conan remote login Use code with caution. Copied to clipboard
For detailed documentation on managing repositories, you can visit the Official Conan Remote Documentation. conan remote — conan 2.27.1 documentation
In the context of the Conan C/C++ package manager , "add remote" refers to configuring the client to communicate with a specific server (repository) to upload or download packages. By default, Conan is configured with Conan Center , but you can add private repositories like JFrog Artifactory or a self-hosted Conan Server 🛠️ Basic Command
To add a new remote, use the following syntax in your terminal: conan remote add
Once a remote is added, you can manage it using these common commands: List Remotes conan remote list conan remote login
: Conan searches remotes in the order they are listed. You can use the
flag to insert a remote at a specific position. For example, conan remote add my-repo
flag allows you to download only package recipes from a remote, ignoring pre-built binaries. Insecure Connections
: If your server uses a self-signed certificate and you don't want to disable SSL globally, you can use the --insecure flag during the add command. Conan Docs 🔗 Official Resources For detailed version-specific documentation, refer to the Conan 2.0 Remotes Guide Conan 1.x Legacy Docs
If you are trying to set up a specific server, I can provide a step-by-step guide for JFrog Artifactory GitLab Package Registry local Conan server . Which one are you using? conan remote — conan 1.66.0 documentation 6 Feb 2026 —
4. Overwriting an Existing Remote
If you need to change the URL of a remote (e.g., your Artifactory server moved): Authentication and Credentials conan add remote only adds
conan add remote mycompany https://new-artifacts.mycompany.com/artifactory/api/conan/cpp-libs --force
Authentication and Credentials
conan add remote only adds the remote configuration; it does not store user credentials. To authenticate with a private remote that requires login, you use:
conan user -p mypassword -r mycompany myusername
Conan then stores an authentication token locally (in ~/.conan2/remotes.json or similar). Future operations with --remote=mycompany will use this token.
Managing Remote List
After adding remotes, you can inspect the order and details with:
conan remote list
Example output:
conancenter: https://center.conan.io [Verify SSL: True]
mycompany: https://artifacts.mycompany.com/artifactory/api/conan/cpp-libs [Verify SSL: True]
To remove a remote:
conan remove remote mycompany
To change priority without re-adding:
conan remote update mycompany --index 0