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 [verify_ssl] Use code with caution. Copied to clipboard : A custom alias for the remote (e.g., my-private-repo : The URL of the Conan repository. [verify_ssl] : Optional; set to (default) or to toggle SSL certificate validation. Conan Docs Advanced Features Prioritize Remotes

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 --insert Use code with caution. Copied to clipboard Force Update

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 [verify_ssl] 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 --insert 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 [VERIFY_SSL] Use code with caution. Copied to clipboard : A unique identifier for the remote (e.g., : The full address of the server. VERIFY_SSL (Optional) (default) or to enable/disable SSL certificate validation. Conan Docs 📋 Key Management Commands conan remote add command to link your Conan

Once a remote is added, you can manage it using these common commands: List Remotes conan remote list conan remote login -p conan remote remove conan remote rename Update URL conan remote update 💡 Advanced Usage Priority & Ordering

: 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 --index 0 makes it the Restricting Packages : You can limit a remote to specific packages using the --allowed-packages flag followed by a pattern (e.g., Recipe-Only Mode --recipes-only

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