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

# Workbench CLI

The Data Science & AI Workbench has a collection of tools that you can use to interact with your instance of Workbench at the operating system (OS) level. Workbench uses the `anaconda-enterprise-cli` package to manage its system via the command line. Everything you need to use the CLI tools is contained in the `ae5-conda-latest-Linux-x86_64.sh` script that is run during environment preparation.

Follow the steps for [administration server setup](/docs/data-science/latest/environment-prep/byok8s-prep#administration-server) on your current machine to install `anaconda-enterprise-cli`.

## Configuring the CLI

Before you can log in to your instance of Workbench, you’ll need to tell the CLI which sites it has access to and which one of the available sites to reach out to and interact with. To configure your CLI, complete the following steps:

1. Add your Workbench repository URL to the list of sites `anaconda-enterprise-cli` can access by running the following command:

   ```sh theme={null}
    # Replace <FQDN> with the fully qualified domain name of your Workbench instance
    # Replace <SITE_NAME> with a short name you want to use to refer to your Workbench site
    anaconda-enterprise-cli config set sites.<SITE_NAME>.url https://<FQDN>/repository/api
   ```
2. Configure your instance of Workbench as the default site for `anaconda-enterprise-cli` to interact with by running the following command:

   ```sh theme={null}
    # Replace <SITE_NAME> with the short name you provided in the previous command
    anaconda-enterprise-cli config set default_site <SITE_NAME>
   ```
3. Verify your configuration was successful by running the following command:

   ```sh theme={null}
    anaconda-enterprise-cli config view
   ```

## Logging in to the CLI

1. Access the CLI by running the following command:

   ```sh theme={null}
    anaconda-enterprise-cli login
   ```
2. Use your Workbench username and password to log in when prompted:

   ```sh theme={null}
    Username: <YOUR_USERNAME>
    Password: <YOUR_PASSWORD>
   ```

## Configuring SSL certificates using the CLI

If you [updated the platform’s TLS/SSL certificate](../../install/certs), you must update the Workbench CLI configurations to use the new repository certificates using the following commands:

<CodeGroup>
  ```sh Generic Linux theme={null}
  anaconda-enterprise-cli config set ssl_verify true
  ```

  ```sh Ubuntu theme={null}
  anaconda-enterprise-cli config set sites.master.ssl_verify /etc/ssl/certs/ca-certificates.crt
  ```

  ```sh RHEL/CentOS theme={null}
  anaconda-enterprise-cli config set sites.master.ssl_verify /etc/pki/tls/certs/ca-bundle.crt
  ```
</CodeGroup>

**Next Steps:**

You can now configure [channels](../chan-pkg/channels#managing-channels-using-the-cli) and [mirrors](../chan-pkg/mirror) for your Workbench users.

## CLI configuration files

The Workbench CLI reads configuration information from the following places:

**System-level configuration:** `/etc/anaconda-platform/cli.yml`

**User-level configuration:** `$INSTALL_PREFIX/anaconda-platform/cli.yml` and `$HOME/.anaconda/anaconda-platform/cli.yml`

To change how the CLI is configured, modify the appropriate `cli.yml` files based on your needs.

<Note>
  Changing configuration settings at the user level overrides any system-level CLI configurations.
</Note>

## Included CLI tools

The Workbench CLI uses multiple tools to interact with your instance and your repositories, and these tools are provided via the `ae5-conda-latest-Linux-x86_64.sh` script.

The script contains the following tools:

| Package                 | Version | Build       | Channel   | Documentation                                                             |
| :---------------------- | :------ | :---------- | :-------- | :------------------------------------------------------------------------ |
| ae5-tools               | 0.4.1   | pypi\_0     | ae5-admin |                                                                           |
| ae5\_backup\_restore    | 0.3.2   | 0           | ae5-admin |                                                                           |
| ae\_preflight           | 0.1.9   | py\_0       | ae5-admin | [ae\_preflight github](https://github.com/Anaconda-Platform/ae-preflight) |
| anaconda-enterprise-cli | 5.5.2   | pypi\_0     | ae5-admin |                                                                           |
| anaconda-mirror         | 5.4.0   | pypi\_0     | defaults  | [Mirroring channels and packages](../chan-pkg/mirror)                     |
| python                  | 3.11.2  | h7a1cb2a\_0 |           |                                                                           |