> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started with Anaconda Platform (Cloud)

export const Comments = ({children}) => {
  return <div class="my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border border-zinc-500/20 bg-zinc-50/50 dark:border-zinc-500/30 dark:bg-zinc-500/10" data-callout-type="comments">
      <div class="w-4">
        <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" xmlns="http://www.w3.org/2000/svg" class="w-5 h-5" aria-label="Comments">
            <path d="M320 112C434.9 112 528 205.1 528 320C528 434.9 434.9 528 320 528C205.1 528 112 434.9 112 320C112 205.1 205.1 112 320 112zM320 576C461.4 576 576 461.4 576 320C576 178.6 461.4 64 320 64C178.6 64 64 178.6 64 320C64 461.4 178.6 576 320 576zM280 400C266.7 400 256 410.7 256 424C256 437.3 266.7 448 280 448L360 448C373.3 448 384 437.3 384 424C384 410.7 373.3 400 360 400L352 400L352 312C352 298.7 341.3 288 328 288L280 288C266.7 288 256 298.7 256 312C256 325.3 266.7 336 280 336L304 336L304 400L280 400zM320 256C337.7 256 352 241.7 352 224C352 206.3 337.7 192 320 192C302.3 192 288 206.3 288 224C288 241.7 302.3 256 320 256z" />
        </svg>
      </div>
      <div class="text-sm prose min-w-0 w-full">
        {children}
      </div>
    </div>;
};

## Before you begin

Using Anaconda Platform (Cloud) requires membership to an [organization](/anaconda-platform/cloud/admin/organizations) with a current [subscription](/anaconda-platform/cloud/admin/subscriptions). If you're working with an Anaconda representative, they will create and subscribe your organization for you.

To get started:

1. Install conda on your computer.
2. Authenticate with `anaconda login`.
3. Configure access to your organization's <Tooltip tip="A location (URL or file path) in a repository where conda looks for packages.">channels</Tooltip>.

Once conda is configured, you can start building <Tooltip tip="A self-contained, isolated space for installing and running software packages.">environments</Tooltip> for your projects using secure, approved <Tooltip tip="Software files and information about the software, such as its name, version, and description, bundled into a file that can be installed and managed by a package manager.">packages</Tooltip>.

## Installing conda

You can obtain conda by installing either Anaconda Distribution or Miniconda.

<Note>
  If you already have conda installed, skip ahead to [Authenticating to Anaconda Platform](#authenticating-to-anaconda-platform).
</Note>

If you do not have conda installed, [install it now](/getting-started/main#choose-your-install-instructions) and return to this page when you're done.

## Authenticating to Anaconda Platform

<Warning>
  You must be [assigned a seat](/anaconda-platform/cloud/admin/members#assigning-organization-seats) within your organization before you can authenticate. If you have not been assigned a seat, contact your organization administrator.
</Warning>

1. Open Anaconda Prompt (Terminal on macOS/Linux).

2. Verify that `anaconda-auth` is installed:

   ```sh theme={null}
   conda list --name base anaconda-auth
   ```

   If the output does not display package information, install it:

   ```sh theme={null}
   conda install --name base anaconda-auth
   ```

3. Log in to Anaconda:

   ```sh theme={null}
   anaconda login
   ```

   A browser window opens to complete the authentication process. If your organization has configured SSO, you are redirected to your company's SSO login page.

   <Note>
     If you belong to more than one organization, use the arrow keys to select the organization you want to authenticate to.
   </Note>

### API key storage

After authentication completes, an API key is generated and stored in your keyring:

<Tabs>
  <Tab title="Windows">
    `C:\Users\<USERNAME>\.anaconda\keyring`
  </Tab>

  <Tab title="macOS/Linux">
    `~/.anaconda/keyring`
  </Tab>
</Tabs>

### Environment logging setup

If your organization has [environments enabled](/anaconda-platform/cloud/admin/environments#enabling-environments), `anaconda login` prompts you to install the necessary plugins for environment logging and scanning. After setup, conda automatically logs any environment you create or update to your registered organization.

```text wrap theme={null}
(base) ➜  ~ anaconda login
Anaconda Environment Manager is required by your organization. It is recommended to install. Proceed? [y/n] (y): y
Installing anaconda-env-manager...
✔︎ anaconda-env-manager installed successfully.
Only one organization found, automatically selecting: my-organization
Linking this machine to organization my-organization...
✔ This machine is now registered with my-organization. Conda environments will be logged to this organization.
```

<Note>
  If you belong to multiple organizations, you are prompted to select one organization from the list before registration completes.
</Note>

For more information, see [Environment logging and scanning](/anaconda-platform/cloud/user/environments).

### Issuing and setting your token

Your organization access token grants conda access to your organization's channels and packages. To issue and set your token, run the following command:

```sh theme={null}
anaconda token install
```

<Note>
  If you belong to more than one organization, you are prompted to select which organization to issue a token for.
</Note>

## Configuring conda to use organization channels

To access packages from your organization's channels, add them to your `.condarc` file:

1. Log in to [anaconda.com/app](https://anaconda.com/app).

2. Select <Icon icon="network-wired" iconType="regular" /> **Channels** from the left-hand navigation.

3. Click <Icon icon="copy" iconType="regular" /> **Copy channel path**.

   <Frame>
     <img src="https://mintcdn.com/anaconda-29683c67/38V1XTpdo_dUNFXe/images/ap_copy_channel_path.png?fit=max&auto=format&n=38V1XTpdo_dUNFXe&q=85&s=9df3426c602908f7ab8cb5c2db4364bd" alt="Copy channel path button" width="1922" height="1082" data-path="images/ap_copy_channel_path.png" />
   </Frame>

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

   ```sh theme={null}
   conda config --prepend channels <CHANNEL_PATH>
   ```

   <Comments>
     Replace \<CHANNEL\_PATH> with the copied channel path.
   </Comments>

   This adds the specified channel to the top of your `channels:` list, giving it top priority when conda searches for packages.

   ```yaml Example .condarc file highlight={5} theme={null}
   channel_settings:
     - channel: https://repo.anaconda.cloud/*
       auth: anaconda-auth
   channels:
     - https://repo.anaconda.cloud/repo/<ORG_ID>/<CHANNEL_NAME>
     - defaults
   add_anaconda_token: true
   default_channels:
     - https://repo.anaconda.cloud/repo/main
   ```

   <Note>
     If you want to use your organization's channels exclusively, ensure they are the only channels in your `.condarc`'s `channels:` list.
   </Note>

For more information about managing channels, see [Channels](/anaconda-platform/cloud/user/channels).

## Using Anaconda behind a firewall or proxy (Optional)

Some companies have security policies that prevent communications on their network with external servers like Anaconda. Under these circumstances, you'll need to connect to your company's firewall/proxy server in order to download packages successfully.

To connect to a firewall/proxy server, you'll need to include a `proxy_servers:` section in the `.condarc` file that contains the URL to the proxy server. This entry must also contain a username and password for logging in to the proxy server. Speak with your IT Administrator if you do not have this information.

There are no commands to include this portion of the `.condarc` file, so you need to manually include the following lines:

<Warning>
  If your password contains special characters, you'll need to [escape them using percent encoding as described here](https://en.wikipedia.org/wiki/Percent-encoding#Percent-encoding_reserved_characters).
</Warning>

```sh theme={null}
proxy_servers:
  http: http://<USERNAME>:<PASSWORD>@<URL>:8080
  https: https://<USERNAME>:<PASSWORD>@<URL>:8443
```

<Comments>
  Replace \<USERNAME> with the username for your proxy server.<br />
  Replace \<PASSWORD> with the password for your proxy server.<br />
  Replace \<URL> with the URL to your proxy server.
</Comments>

You'll also need to work with your IT team to allowlist connections to the main package repositories once you've configured your connection to the firewall/proxy server. The main package repositories are:

```sh theme={null}
https://conda.anaconda.org
https://repo.anaconda.com
https://repo.anaconda.cloud
```

In some situations, it is necessary to export the `HTTP_PROXY` and `HTTPS_PROXY` environment variables to utilize the proxy server. To export your environment variables, open a terminal and run the following commands:

```sh theme={null}
export HTTP_PROXY=http://<USERNAME>:<PASSWORD>@<URL>:8080
export HTTPS_PROXY=https://<USERNAME>:<PASSWORD>@<URL>:8443
```

<Comments>
  Replace \<USERNAME> with the username for your proxy server.<br />
  Replace \<PASSWORD> with the password for your proxy server.<br />
  Replace \<URL> with the URL to your proxy server.
</Comments>

For more information about using conda behind a proxy server, see [Configure conda for use behind a proxy server](https://docs.conda.io/projects/conda/en/latest/user-guide/configuration/settings.html#proxy-servers-configure-conda-for-use-behind-a-proxy-server).

## Verifying your configuration

Test your configuration by creating an environment and installing a package:

1. Create a test environment:

   ```sh theme={null}
   conda create --name <ENV_NAME>
   ```

   <Comments>
     Replace \<ENV\_NAME> with a name for your environment.
   </Comments>

2. Verify the environment was created:

   ```sh theme={null}
   conda env list
   ```

3. Activate the environment:

   ```sh theme={null}
   conda activate <ENV_NAME>
   ```

   <Comments>
     Replace \<ENV\_NAME> with the name of your environment.
   </Comments>

4. Install a package:

   ```sh theme={null}
   conda install <PKG_NAME>
   ```

   <Comments>
     Replace \<PKG\_NAME> with the name of the package you want to download from your channel.
   </Comments>

5. If necessary, delete the environment to clean up:

   ```sh theme={null}
   conda env remove --name <ENV_NAME>
   ```

   <Comments>
     Replace \<ENV\_NAME> with the name of your environment.
   </Comments>