> ## 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

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>;
};

export const GCell = ({children, className}) => <div className={`grid-table-cell ${className || ""}`} role="cell">
    {children}
  </div>;

export const GTH = ({children, className}) => <div className={`grid-table-th ${className || ""}`} role="columnheader">
    {children}
  </div>;

export const GRow = ({children}) => <div className="grid-table-row" role="row">{children}</div>;

export const GBody = ({children}) => <div className="grid-table-body" role="rowgroup">{children}</div>;

export const GHead = ({children}) => <div className="grid-table-head" role="rowgroup">{children}</div>;

export const GTable = ({children, className, cols}) => <div className={`grid-table not-prose overflow-hidden rounded-2xl ${className || ""}`} style={{
  "--grid-table-cols": cols
}} role="table">
    {children}
  </div>;

`anaconda-client` is the command-line interface and client library for [Anaconda.org](https://anaconda.org). Use it to search for, upload, download, and manage packages, manage labels and collaborators, and configure authorization tokens—all from your terminal.

<Note>
  Most of these commands use the `anaconda org` command structure. Commands without the `org` prefix (for example, `anaconda auth`) are still supported.
</Note>

## Installation

To install `anaconda-client`, open [Anaconda Prompt](/reference/glossary#anaconda-prompt) (Terminal on macOS/Linux) and run the following command:

```sh theme={null}
conda install anaconda-client
```

If you installed Anaconda Distribution, `anaconda-client` should already be in your `base` environment. To check, run the following command:

```sh theme={null}
conda list anaconda-client
```

<Accordion title="Alternative installation methods">
  <CodeGroup>
    ```sh pip theme={null}
    pip install anaconda-client
    ```

    ```sh pip from source theme={null}
    pip install git+https://github.com/anaconda/anaconda-client
    ```
  </CodeGroup>
</Accordion>

To verify your installation and view the installed version:

```sh theme={null}
anaconda --version
```

## Basic usage

### Log in to Anaconda.org

To log in to your Anaconda.org account:

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

Log in with your Anaconda credentials. Once authenticated, subsequent commands use your stored credentials automatically.

### Check authentication status

To display information about the currently signed-in user:

```sh theme={null}
anaconda org whoami
```

### Search for a package

To search for a package on Anaconda.org:

```sh theme={null}
anaconda org search <PACKAGE_NAME>
```

<Comments>
  Replace \<PACKAGE\_NAME> with the name of the package to search for.
</Comments>

### Upload a package

To upload a package to Anaconda.org:

```sh theme={null}
anaconda org upload <FILE>
```

<Comments>
  Replace \<FILE> with the path to the distribution file to upload (for example, a `.conda` or `.tar.bz2` file).
</Comments>

### Log out

To remove stored credentials:

```sh theme={null}
anaconda org logout
```

## Configuration

`anaconda-client` reads configuration from a YAML file. Use the `anaconda config` command to view or modify settings.

### View configuration

To display all configuration variables:

```sh theme={null}
anaconda org config --show
```

To display config file locations:

```sh theme={null}
anaconda org config --files
```

### Set a configuration value

```sh theme={null}
anaconda org config --set <NAME> <VALUE>
```

<Comments>
  Replace \<NAME> with the configuration variable name.<br />
  Replace \<VALUE> with the preferred value.
</Comments>

### Configuration scopes

<GTable cols="20% 20% 60%">
  <GHead>
    <GRow>
      <GTH>Scope</GTH>
      <GTH>Flag</GTH>
      <GTH>Description</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>User</GCell>
      <GCell>`-u, --user`</GCell>
      <GCell>Set a variable for the current user (default)</GCell>
    </GRow>

    <GRow>
      <GCell>System</GCell>
      <GCell>`-s, --system`</GCell>
      <GCell>Set a variable for all users on this machine</GCell>
    </GRow>
  </GBody>
</GTable>

### Common configuration options

<GTable cols="20% 35% 45%">
  <GHead>
    <GRow>
      <GTH>Parameter</GTH>
      <GTH>Default</GTH>
      <GTH>Description</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>`url`</GCell>
      <GCell>`https://api.anaconda.org`</GCell>
      <GCell>Anaconda.org API URL</GCell>
    </GRow>

    <GRow>
      <GCell>`ssl_verify`</GCell>
      <GCell>`True`</GCell>
      <GCell>Enable SSL verification for API requests</GCell>
    </GRow>

    <GRow>
      <GCell>`auto_register`</GCell>
      <GCell>`True`</GCell>
      <GCell>Automatically create a package namespace when uploading if it does not exist</GCell>
    </GRow>
  </GBody>
</GTable>

For the full list of `config` options, see the [config command reference](/cli-reference/anaconda-client/commands/config).