Skip to main content
Anaconda requires a one-time registration when connecting from certain networks or IP addresses. If your conda client directed you to this page, it’s because you’re connecting from a network that requires registration. Registration is quick and painless, and gives you access to powerful cloud features like browser-hosted notebooks, environment backups, project syncing, and effortless notebook sharing. Once registered, your conda client is automatically authenticated going forward.
If you are an administrator, you can streamline registration for your organization. For more information, see Registering conda for your organization.
If you encounter any issues with the registration process, please contact [email protected] for help.
Follow the steps below to link your desktop conda client to your Anaconda account. If you use conda in Docker or CI/CD workflows, additional steps are provided below after you’ve registerd your client.
  1. Open Anaconda Prompt (Terminal on macOS/Linux).
  2. If necessary, activate your base environment: 
    conda activate base
  3. Install anaconda-registration: 
    conda install --name base anaconda-registration --channel https://repo.anaconda.cloud/repo/anaconda-tools --override-channels
    The --channel and --override-channels command options allow installation to succeed, despite the registration block.
    If you encounter an error at this point, see Troubleshooting below.
  4. Log in to Anaconda: 
    anaconda login --at anaconda.com
    A browser window opens to authenticate you to Anaconda. Sign in with your Anaconda account credentials, or create an account, to complete authentication in the browser. If you are already signed in to Anaconda, authentication completes automatically.
    If your organization has configured SSO, you are redirected to your company’s SSO login page.
    Your conda client is now registered to your Anaconda account.

​
Next steps for automated workflows

If your conda client runs as part of an automated process, such as a CI/CD pipeline, or if you are using conda within Docker builds on your desktop, configure them to use your local API key (generated when you logged in using anaconda-auth) to authenticate conda using one of the following methods:
  • Using an environment variable
  • Using the keyring
  • Docker
  1. Open Anaconda Prompt or Powershell (Terminal on macOS/Linux).
  2. Set your API key as an environment variable: 
    for /f "usebackq delims=" %i in (`anaconda auth api-key`) do set ANACONDA_AUTH_API_KEY=%i

​
Troubleshooting

AnacondaAuthError: Token not found
Cause
This error occurs if you’ve previously installed a version of anaconda-auth that is not compatible with the registration process.
Solution
To resolve the error, run the command:
conda remove --name base anaconda-auth --force
Then repeat the command to install anaconda-registration.