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, notebooks, and environments

  • 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, notebook, or environment.

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, notebook, or environment, you can create an organization and groups within that organization.

Note

By default, tokens expire after one year.

Scopes#

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

The available scopes are:

  • all - Allow all operations

  • api - Allow all API operations

  • api:modify-group - Allow addition and modification of groups

  • api:read - Allow read access to the API site

  • api:write - Allow write access to the API site

  • conda - Allow all operations on conda repositories

  • conda:download - Allow private downloads from conda repositories

  • pypi - Allow all operations on Standard Python repositories

  • pypi:download - Allow private downloads from Standard Python repositories

  • pypi:upload - Allow uploads to Standard Python repositories

  • repos - Allow access to all package repositories

Generating a token on Anaconda.org#

  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 the token strength.

    3. Set the required scopes for your use case.

    4. Set the expiration date.

A notification appears containing your token. You can view the token at any time at the bottom of the Access page.

  1. Click Create.

Generating a token in the CLI#

  1. Open a terminal (Anaconda Prompt for Windows users) and run the following command:

    # Replace <YOUR_TOKEN_NAME> with a name of your choosing
    # Replace <SCOPE> with a scope listed above
    anaconda auth --create --name <YOUR_TOKEN_NAME> --scopes 'repos <SCOPE>'
    

    This generates a random alphanumeric token string, which you can then distribute to fellow Anaconda.org users to enable them to download a package that you have marked private. The token produced in this example provides access to download any of your private conda repositories.

  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>
    

Note

If you lose your token string, 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).

Revoking a token on Anaconda.org#

  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.

Revoking a token in the CLI#

  1. Open a terminal (Anaconda Prompt for Windows users) 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>