anaconda-auth
package handles authentication across the Anaconda ecosystem. If you’re using Anaconda CLIs or APIs, you’ll use this package to log in, manage API keys, and configure secure access to Anaconda’s curated repositories.
This tool supports both command-line and Python interfaces, and stores credentials using system keyring or a dedicated file-based store.
anaconda-auth
anaconda-auth
by running the following command:
anaconda-auth
installed, it’s best practice to update to the latest version from time to time:anaconda auth
and anaconda token
commands:
Option | Description |
---|---|
--version , -V | Show version and exit |
--help | Show help message |
Command | Description | Arguments |
---|---|---|
login | Open browser to authenticate with Anaconda | [anaconda.com , anaconda.org ] [default: None] |
logout | Remove stored API key | |
whoami | Show the authenticated user | |
api-key | Print your current API key |
anaconda-auth
also allows for authentication to Anaconda.org. If you do not include --at anaconda.com
, you will be prompted to select a domain.Option | Description |
---|---|
--help | Show help message |
Command | Description | Arguments |
---|---|---|
install | Issue and set a new token | |
list | Show all installed tokens | |
config | Configure conda to use a token for private access | --force --no-force Default: no-force |
uninstall | Remove a token for a specific organization | --org <ORG_ID> |
<ORG_ID>
is part of your organization’s URL: https://anaconda.com/app/organizations/<ORG_ID>
.anaconda-auth
, a token is stored in the specified storage location. This token is deleted when you log out. The auth token is valid for one year.anaconda-auth
by either:
~/.anaconda/config.toml
file.ANACONDA_AUTH_
environment variables or using a .env
file in your working directory..env
file in your working directory takes precedence over the ~/.anaconda/config.toml
file.Config Key | Env Var | Description | Default |
---|---|---|---|
domain | ANACONDA_AUTH_DOMAIN | Anaconda API domain | "anaconda.com" |
ssl_verify | ANACONDA_AUTH_SSL_VERIFY | Verify SSL certificates | true |
preferred_token_storage | ANACONDA_AUTH_PREFERRED_TOKEN_STORAGE | Token store: system or anaconda-keyring | "anaconda-keyring" |
api_key | ANACONDA_AUTH_API_KEY | Explicit API key if None , defaults to keyring storage | None |
extra_headers | ANACONDA_AUTH_EXTRA_HEADERS | Extra HTTP headers in JSON | None |
Example Config
preferred_token_storage
is set to "anaconda-keyring"
.
~/.anaconda/keyring
file.
~/.anaconda/keyring
file to the non-interactive system:
anaconda-auth
in scripts and applications to authenticate programmatically.
login()
does nothing. To override this behavior:
anaconda-auth
to make API requests, see the official anaconda-auth docs on GitHub.