Quickstart guide for Commercial Edition¶
To set up Commercial Edition, you will need to make updates to the anaconda or conda configuration file called
.condarc. The changes will update the source repository configuration to access the Commercial Edition repository located at repo.anaconda.cloud.
The Commercial Edition repository also requires a token for access.
Completely new to Commercial Edition? Start by creating an account.
Already have an account, a profile, and your new Commercial Edition subscription? Skip ahead to learn how to authenticate Commercial Edition.
This topic provides guidance on the following actions:
- What’s available to you through Commercial Edition
- Creating an account
- Creating a profile
- Purchasing Commercial Edition
- Installing Anaconda
- Authenticating Commercial Edition
What’s available to you through Commercial Edition¶
The following active channels are available for sourcing packages:
The following archived channels are available for sourcing packages:
Creating an account¶
Go to https://anaconda.cloud/register to access the Get started with Commercial Edition page, where you will be prompted to create an account.
Complete the following steps:
- Enter your email address and a secure password.
- Check the box next to Agree to agree to our Terms of Service.
- Check the Captcha box.
- Click Create My Account.
You will then be directed to the Create a profile page.
Creating a profile¶
Fill out the Personal Information form, select whether you would like to opt in or opt out of marketing promotions or newsletters, and then click Save and Continue to proceed to the Purchase Commercial Edition page.
You will receive a verification email once you have created your profile.
Purchasing Commercial Edition¶
Complete the following steps:
- Select either a monthly or annual subscription.
- Enter your billing information.
- Check the box stating that you agree to the Anaconda End-User License Agreement.
- Click Purchase Now.
You will then be directed to the Purchase Summary page, which includes details on accessing Commercial Edition.
You will receive two emails: one confirming your purchase and another containing your token.
The email containing your private access token also contains the
.condarc configuration with your token already embedded, allowing you to see (and copy!) your personal
If you already have Anaconda Individual Edition or miniconda installed, you’re all set to move forward!
If you have not installed Individual Edition or miniconda yet, please do so from the Individual Edition installation section before proceeding with authentication.
Authenticating Commercial Edition¶
A private token will be sent to the email address you provided when you created your account. You will need this token to activate your account and gain access to repo.anaconda.cloud.
In order to authenticate Commercial Edition, you will need to configure conda by editing the
You can configure
.condarc by editing the file in one of the paths listed in the next section or by running
You must keep your token private.
Searching for .condarc¶
Windows system paths: 'C:\ProgramData\conda\.condarc', 'C:\ProgramData\conda\condarc', 'C:\ProgramData\conda\condarc.d', Linux and macOS system paths: '/etc/conda/.condarc', '/etc/conda/condarc', '/etc/conda/condarc.d/', '/var/lib/conda/.condarc', '/var/lib/conda/condarc', '/var/lib/conda/condarc.d/', Local paths on all platforms: '$CONDA_ROOT/.condarc', '$CONDA_ROOT/condarc', '$CONDA_ROOT/condarc.d/', '~/.conda/.condarc', '~/.conda/condarc', '~/.conda/condarc.d/', '~/.condarc', '$CONDA_PREFIX/.condarc', '$CONDA_PREFIX/condarc', '$CONDA_PREFIX/condarc.d/', '$CONDARC', )
CONDA_ROOT is the path for your base conda or Anaconda install.
CONDA_PREFIX is the path to the current active environment.
~ means home directory on Linux, Mac and Windows.
If you run conda config commands they will write to
~/.condarc by default, but the location can be changed with the following arguments.
Setting up .condarc for Commercial Edition¶
Here are the recommended contents of the
restore_free_channel: false default_channels: # Replace <TOKEN> with your personal token. - https://repo.anaconda.cloud/t/<TOKEN>/repo/main - https://repo.anaconda.cloud/t/<TOKEN>/repo/msys2 - https://repo.anaconda.cloud/t/<TOKEN>/repo/r # Uncomment these only if you need them # - https://repo.anaconda.cloud/t/<TOKEN>/repo/free # - https://repo.anaconda.cloud/t/<TOKEN>/repo/pro # - https://repo.anaconda.cloud/t/<TOKEN>/repo/mro-archive # - https://repo.anaconda.cloud/t/<TOKEN>/repo/mro channels: - defaults
Default_channels is used here to ensure that conda will not pull any packages from repo.anaconda.com.
You can add other channels from anaconda.org after
defaults. Learn more about using default repositories in our Individual Edition documentation.
If you need to use the free channel, you must uncomment the line with your token but keep
restore_free_channel set to
Configure .condarc using conda config commands¶
The following commands can be used to configure the
.condarc file from any state to correctly authenticate Commercial Edition:
# Replace <TOKEN> with your personal token. > conda config --set restore_free_channel false > conda config --prepend default_channels https://repo.anaconda.cloud/t/<TOKEN>/repo/main > conda config --append default_channels https://repo.anaconda.cloud/t/<TOKEN>/repo/msys2 > conda config --append default_channels https://repo.anaconda.cloud/t/<TOKEN>/repo/r > conda config --prepend channels defaults
by default, the conda config commands above will edit the condarc file in the home directory.
Using the conda config file location flags below, you can change the path to the
.condarc file you wish to edit.
Config File Location Selection: Without one of these flags, the user config file at '/Users/<USERNAME>/.condarc' is used. --system Write to the system .condarc file at '/Users/<USERNAME>/Applications/miniconda3/.condarc'. --env Write to the active conda environment .condarc file (/ Users/<USERNAME>/Applications/miniconda3). If no environment is active, write to the user config file (/Users/<USERNAME>/.condarc). --file FILE Write to the given file.
<USERNAME> is your Anaconda username.
The following commands can be run if you need these channels as well:
# Replace <TOKEN> with your personal token. > conda config --append default_channels https://repo.anaconda.cloud/t/<TOKEN>/repo/free > conda config --append default_channels https://repo.anaconda.cloud/t/<TOKEN>/repo/pro
Ensuring .condarc is configured correctly¶
In order to ensure that your
.condarc file is configured correctly, either by running
conda config or editing the file directly, run the command
conda info in the terminal. As you can see in the example output below, the channel URLs specify repo.anaconda.cloud, not repo.anaconda.com.
>conda info active environment : base active env location : /Users/<USERNAME>/Applications/miniconda3 shell level : 1 user config file : /Users/<USERNAME>/.condarc populated config files : /Users/<USERNAME>/.condarc conda version : 4.8.4 conda-build version : 3.18.11 python version : 3.7.7.final.0 virtual packages : __osx=10.14.6 base environment : /Users/<USERNAME>/Applications/miniconda3 (writable) channel URLs : https://repo.anaconda.cloud/t/<TOKEN>/repo/main/osx-64 https://repo.anaconda.cloud/t/<TOKEN>/repo/main/noarch https://repo.anaconda.cloud/t/<TOKEN>/repo/msys2/osx-64 https://repo.anaconda.cloud/t/<TOKEN>/repo/msys2/noarch package cache : /Users/<USERNAME>/Applications/miniconda3/pkgs /Users/<USERNAME>/.conda/pkgs envs directories : /Users/<USERNAME>/Applications/miniconda3/envs /Users/<USERNAME>/.conda/envs platform : osx-64 user-agent : conda/4.8.4 requests/2.24.0 CPython/3.7.7 Darwin/18.7.0 OSX/10.14.6 UID:GID : 502:20 netrc file : None offline mode : False