Accounts#

All Anaconda.org users can find, download, and use packages without having an Anaconda.org account. This means packages you upload to your Anaconda.org account are accessible to everyone. However, you need to create an Anaconda.org account in order to do the following:

  • Author packages

  • Upload packages

  • Access shared, private packages

  • Create organizations

Creating a free account#

Follow these steps to sign up for a free Anaconda.org account:

  1. In a browser, go to Anaconda.org.

  2. Make sure the Sign Up tab is active.

  3. Enter a username.

  4. Enter your email address.

    Note

    Users who register with an .edu email are granted some additional features.

  5. Create a password.

    Note

    The password must be at least seven characters long.

  6. Enter the password again to confirm it.

  7. Read and accept the Terms and Conditions.

  8. Confirm you are not a robot.

  9. Click Register For Free.

  10. Verify your account from the email sent to you.

  11. Log in to your free account and view your personal dashboard.

Tip

Anaconda.org displays your profile photo if the email address you used to register on Anaconda.org is associated with a Gravatar account. To associate your email address or change your Gravatar profile photo, go to gravatar.com.

Resetting your password#

Follow these steps to reset your password:

  1. Log in to Anaconda.org.

  2. From your profile in the top-right corner, select Settings.

  3. Click My Account in the left-hand menu. Verify your password if prompted.

  4. In the Change Password section, enter your old password, then enter and confirm a new password.

  5. Click Change Password.

Upgrading or downgrading your plan#

If you require more private packages or storage space than is included in a personal plan, contact Anaconda so we can customize a plan for you.

Creating access tokens#

The best way to manage access or make packages private is to create organizations or groups, which allow you to set separate permissions per package.

You can also control access with the Token system. You can use tokens to control access to private repositories, collections, or packages on Anaconda.org. Additionally, the degree of access a token grants is completely configurable at the time of generation. You can generate multiple tokens to control which groups of users have access to certain features if they have the appropriate token.

Generating tokens#

Tokens provide varying degrees of access to content within a specified channel depending on the scope assignment. If you need to separate permission levels by package, you can create an organization and groups within that organization.

Note

By default, tokens expire after one year.

  1. Open Anaconda Prompt (Terminal on macOS/Linux) and run the following command:

    # Replace <YOUR_TOKEN_NAME> with a name of your choosing
    # Replace <SCOPE> with a scope(s) from the Scopes dropdown below
    anaconda auth --create --name <YOUR_TOKEN_NAME> --scopes '<SCOPE1> <SCOPE2>'
    

    This generates a random alphanumeric string. That string is your token! You can distribute your token to other Anaconda.org users to provide them with a specific, limited set of permissions to interact with your Anaconda.org assets.

  2. Add the token to your channel path in your .condarc file by running the following command:

    # Replace <TOKEN> with your token string
    # Replace <CHANNEL> with the channel name
    conda config --add channels https://conda.anaconda.org/t/<TOKEN>/<CHANNEL>
    

    Or, add a channel with a token and a label:

    # Replace <TOKEN> with your token string
    # Replace <CHANNEL> with the channel name
    # Replace <YOUR_TOKEN_NAME> with the label name used in the previous step
    conda config --add channels https://conda.anaconda.org/t/<TOKEN>/<CHANNEL>/label/<YOUR_TOKEN_NAME>
    
Scopes

Assign scopes to tokens to set permission levels for token holders. Scopes are provided as a space-separated, quoted list.

Available scopes:

Scope

Permission

all

Allow all operations

repos

Allow access to all package repositories

pypi

Allow all operations on Standard Python repositories

pypi:upload

Provides upload permissions to Standard Python repositories

pypi:download

Provides download permissions for private packages in Standard Python repositories

conda

Allow all operations on conda repositories

conda:download

Provides download permissions for private packages in conda repositories

api

Allow all API operations

api:write

Provides write permissions to actions performed via API

api:read

Provides read permissions to actions performed via API

api:modify-group

Provides manage permissions to groups via the API

  1. Log in to Anaconda.org.

  2. From your profile in the top-right corner, select Settings.

  3. Click Access in the left-hand menu.

  4. Fill out the Create access token form:

    1. Provide a unique token name.

    2. Set your token strength to strong (longer token). This generates a strong, completely unique token that is difficult to guess with brute force methods.

    3. Set the required scopes for your use case.

    4. Set the expiration date.

    A notification appears containing your token.

Tip

You can view the token at any time at the bottom of the Access page.

  1. Click Create.

Note

If your token expires, revoke the token and create a new one.

Revoking tokens#

You can revoke tokens directly on Anaconda.org or from the command line interface (CLI).

  1. Open Anaconda Prompt (Terminal on macOS/Linux) and run the following command:

    # Replace <YOUR_TOKEN_NAME> with the name of the token you want to revoke
    anaconda auth -r <YOUR_TOKEN_NAME>
    
  1. Log in to Anaconda.org.

  2. From your profile in the top-right corner, select Settings.

  3. Click Access in the left-hand menu.

  4. At the bottom of the page, click the name of the token you want to revoke.

  5. Click Revoke Token.