conan remote¶
Use this command to add, edit and remove Conan repositories from the Conan remote registry and also manage authentication to those remotes. For more information on how to work with Conan repositories, please check the dedicated section.
$ conan remote -h
WARN: Downgrading cache from Conan 2.4.1 to 2.0.17
WARN: Applying downgrade migration 2.4_1-migrate.py
Migration: Successfully updated cppstd_compat.py
usage: conan remote [-h] [-v [V]]
{add,auth,disable,enable,list,list-users,login,logout,remove,rename,set-user,update}
...
Manage the remote list and the users authenticated on them.
positional arguments:
{add,auth,disable,enable,list,list-users,login,logout,remove,rename,set-user,update}
sub-command help
add Add a remote.
auth Authenticate in the defined remotes
disable Disable all the remotes matching a pattern.
enable Enable all the remotes matching a pattern.
list List current remotes.
list-users List the users logged into all the remotes.
login Login into the specified remotes matching a pattern.
logout Clear the existing credentials for the specified
remotes matching a pattern.
remove Remove a remote.
rename Rename a remote.
set-user Associate a username with a remote matching a pattern
without performing the authentication.
update Update a remote.
options:
-h, --help show this help message and exit
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
conan remote add¶
$ conan remote add -h
WARN: Downgrading cache from Conan 2.1.0 to 2.0.17
usage: conan remote add [-h] [-v [V]] [--insecure] [--index INDEX] [-f]
name url
Add a remote.
positional arguments:
name Name of the remote to add
url Url of the remote
options:
-h, --help show this help message and exit
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug, -vvv or
-vtrace
--insecure Allow insecure server connections when using SSL
--index INDEX Insert the remote at a specific position in the remote list
-f, --force Force the definition of the remote even if duplicated
conan remote auth¶
$ conan remote auth -h
WARN: Downgrading cache from Conan 2.1.0 to 2.0.17
usage: conan remote auth [-h] [-f FORMAT] [-v [V]] [--with-user] remote
Authenticate in the defined remotes
positional arguments:
remote Pattern or name of the remote/s to authenticate
against. The pattern uses 'fnmatch' style wildcards.
options:
-h, --help show this help message and exit
-f FORMAT, --format FORMAT
Select the output format: json
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
--with-user Only try to auth in those remotes that already have a
username or a CONAN_LOGIN_ env-var defined
conan remote disable¶
$ conan remote disable -h
WARN: Downgrading cache from Conan 2.3.2 to 2.0.17
usage: conan remote disable [-h] [-f FORMAT] [-v [V]] remote
Disable all the remotes matching a pattern.
positional arguments:
remote Pattern of the remote/s to disable. The pattern uses
'fnmatch' style wildcards.
options:
-h, --help show this help message and exit
-f FORMAT, --format FORMAT
Select the output format: json
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
conan remote enable¶
$ conan remote enable -h
WARN: Downgrading cache from Conan 2.3.2 to 2.0.17
usage: conan remote enable [-h] [-f FORMAT] [-v [V]] remote
Enable all the remotes matching a pattern.
positional arguments:
remote Pattern of the remote/s to enable. The pattern uses
'fnmatch' style wildcards.
options:
-h, --help show this help message and exit
-f FORMAT, --format FORMAT
Select the output format: json
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
conan remote list¶
$ conan remote list -h
WARN: Downgrading cache from Conan 2.4.1 to 2.0.17
WARN: Applying downgrade migration 2.4_1-migrate.py
Migration: Successfully updated cppstd_compat.py
usage: conan remote list [-h] [-f FORMAT] [-v [V]]
List current remotes.
options:
-h, --help show this help message and exit
-f FORMAT, --format FORMAT
Select the output format: json
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
conan remote list-users¶
$ conan remote list-users -h
Error executing: conan remote list-users -h
WARN: Downgrading cache from Conan 2.4.1 to 2.0.17
WARN: Applying downgrade migration 2.4_1-migrate.py
Migration: Successfully updated cppstd_compat.py
ERROR: [Errno 2] No such file or directory: '/root/.conan2/migrations/2.4_1-migrate.py'
conan remote login¶
$ conan remote login -h
WARN: Downgrading cache from Conan 2.1.0 to 2.0.17
usage: conan remote login [-h] [-f FORMAT] [-v [V]] [-p [PASSWORD]]
remote [username]
Login into the specified remotes matching a pattern.
positional arguments:
remote Pattern or name of the remote to login into. The
pattern uses 'fnmatch' style wildcards.
username Username
options:
-h, --help show this help message and exit
-f FORMAT, --format FORMAT
Select the output format: json
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
-p [PASSWORD], --password [PASSWORD]
User password. Use double quotes if password with
spacing, and escape quotes if existing. If empty, the
password is requested interactively (not exposed)
conan remote logout¶
$ conan remote logout -h
WARN: Downgrading cache from Conan 2.1.0 to 2.0.17
usage: conan remote logout [-h] [-f FORMAT] [-v [V]] remote
Clear the existing credentials for the specified remotes matching a pattern.
positional arguments:
remote Pattern or name of the remote to logout. The pattern
uses 'fnmatch' style wildcards.
options:
-h, --help show this help message and exit
-f FORMAT, --format FORMAT
Select the output format: json
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
conan remote remove¶
$ conan remote remove -h
WARN: Downgrading cache from Conan 2.3.2 to 2.0.17
usage: conan remote remove [-h] [-v [V]] remote
Remove a remote.
positional arguments:
remote Name of the remote to remove. Accepts 'fnmatch' style wildcards.
options:
-h, --help show this help message and exit
-v [V] Level of detail of the output. Valid options from less verbose
to more verbose: -vquiet, -verror, -vwarning, -vnotice,
-vstatus, -v or -vverbose, -vv or -vdebug, -vvv or -vtrace
conan remote rename¶
$ conan remote rename -h
WARN: Downgrading cache from Conan 2.2.3 to 2.0.17
usage: conan remote rename [-h] [-v [V]] remote new_name
Rename a remote.
positional arguments:
remote Current name of the remote
new_name New name for the remote
options:
-h, --help show this help message and exit
-v [V] Level of detail of the output. Valid options from less verbose
to more verbose: -vquiet, -verror, -vwarning, -vnotice,
-vstatus, -v or -vverbose, -vv or -vdebug, -vvv or -vtrace
conan remote set-user¶
$ conan remote set-user -h
WARN: Downgrading cache from Conan 2.4.1 to 2.0.17
usage: conan remote set-user [-h] [-f FORMAT] [-v [V]] remote username
Associate a username with a remote matching a pattern without performing the
authentication.
positional arguments:
remote Pattern or name of the remote. The pattern uses
'fnmatch' style wildcards.
username Username
options:
-h, --help show this help message and exit
-f FORMAT, --format FORMAT
Select the output format: json
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
conan remote update¶
$ conan remote update -h
WARN: Downgrading cache from Conan 2.3.2 to 2.0.17
usage: conan remote update [-h] [-v [V]] [--url URL] [--secure] [--insecure]
[--index INDEX]
remote
Update a remote.
positional arguments:
remote Name of the remote to update
options:
-h, --help show this help message and exit
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug, -vvv or
-vtrace
--url URL New url for the remote
--secure Don't allow insecure server connections when using SSL
--insecure Allow insecure server connections when using SSL
--index INDEX Insert the remote at a specific position in the remote list