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 support@anaconda.com 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 additional “channel” command options allow installation to succeed, despite the registration block.
  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 (Terminal on macOS/Linux).
  2. Retrieve your API key by running the following command: 
    anaconda auth api-key
  3. On your automated workflow system, set the ANACONDA_AUTH_API_KEY environment variable: 
    # Replace <YOUR_API_KEY> with the return from the previous command
export ANACONDA_AUTH_API_KEY="<YOUR_API_KEY>"