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

# Login

> Authenticate with Chroma Cloud using the CLI.

The Chroma CLI allows you to perform various operations with your Chroma Cloud account. These include [DB management](./db), [collection copying](./copy) and [browsing](./browse), and many more to come in the future.

Use the `login` command, to authenticate the CLI with your Chroma Cloud account, to enable these features.

First, in your browser [create](https://trychroma.com/signup?utm_source=docs-cli-login) a Chroma Cloud account or [login](https:trychroma.com/login) into your existing account.

Then, in your terminal, run

```bash theme={null}
chroma login
```

The CLI will open a browser window verifying that the authentication was successful. If so, you should see the following:

<img src="https://mintcdn.com/chroma-8943dec5/N-xA4EbmHOvIcCcs/images/cli/cli-login-success.png?fit=max&auto=format&n=N-xA4EbmHOvIcCcs&q=85&s=71d6a0db04743b124eb5953ed7faaa54" alt="CLI login success" width="1124" height="998" data-path="images/cli/cli-login-success.png" />

Back in the CLI, you will be prompted to select the team you want to authenticate with. Each team login gets its own [profile](./profile) in the CLI. Profiles persist the API key and tenant ID for the team you log-in with. You can find all your profiles in `.chroma/credentials` under your home directory. By default, the name of the profile is the same name of the team you logged-in with. However, the CLI will let you edit that name during the login, or later using the `chroma profile rename` command.

Upon your first login, the first created profile will be automatically set as your "active" profile.

On subsequent logins, the CLI will instruct you how to switch to a new profile you added (using the `chroma profile use` command).

In order to login without a browser (for example, in a headless environment), you first need to create an API key in the Chroma Cloud dashboard and then run

```bash theme={null}
chroma login --profile my_profile_name --api-key ck-...
```
