Command reference — Anaconda Enterprise 4.4 documentation

Anaconda Enterprise: Documentation

# Command reference

Anaconda Client is the command line interface (CLI) to Anaconda Repository. You can use it to log in, log out, manage your account, upload files, generate access tokens, view tokens and other tasks.

The full Client command reference is shown below. You can also view this command reference in a terminal window with the command `anaconda --help` or `anaconda -h`.

See also: Anaconda Cloud API Reference.

- anaconda
- Authentication
  - auth
  - login
  - whoami
- Informational
  - show
  - search
  - config
- Package management
  - package
  - upload
  - label
  - copy

## anaconda

Repository command line manager.

## Authentication

### auth

Manage authorization tokens.

See also token.

### login

Authenticate a user.

### whoami

Print the information of the current user.

## Informational

### show

Show information about an object.

EXAMPLE:

    anaconda show anaconda
    anaconda show anaconda/python
    anaconda show anaconda/python/2.7.5
    anaconda show anaconda/python/2.7.5/linux-64/python-2.7.5-0.tar.bz2

### search

Search Repository for packages.

### config

Binstar configuration.

#### Client configuration

Get, set, remove or show the Client configuration.

#### Client sites

Client sites are a mechanism to allow users to quickly switch between Repository instances. This can be used with the on-site Anaconda Enterprise.

- Invoke the anaconda command with the `-s/--site` option like this:

      anaconda -s site_name whoami

- Set a site as the default:

      anaconda config --set default_site site_name
      anaconda whoami

##### Add a Client site

After installing Anaconda Enterprise, you can add a site named “site_name” as follows:

    anaconda config --set sites.site_name.url
    "http://<anaconda-enterprise-ip>:<port>/api"
    anaconda config --set default_site site_name

##### Site options vs. global options

All options can be set as global options that affect all sites or site options that affect only one site.

By default, options are set globally:

    anaconda config --set OPTION VALUE

If you want the option to be limited to a single site, prefix the option with `sites.site_name`:

    anaconda config --set sites.site_name.OPTION VALUE

##### Common Client configuration options

- Url—Set the Anaconda API URL. Default is `https://api.anaconda.org`.
- Verify_ssl—Perform SSL validation on the https requests. Verify_ssl may be `True`, `False` or a path to a root CA pem file.

#### Toggle auto_register when doing anaconda upload

The default is `yes`, automatically creating a new package when uploading. If `no`, then an upload fails if the package name does not already exist on the server:

    anaconda config --set auto_register yes|no

## Package management

### package

Repository package utilities.

### upload

Upload packages to Repository.

    anaconda upload CONDA_PACKAGE_1.bz2
    anaconda upload notebook.ipynb
    anaconda upload environment.yml

See also:

- Uploading a conda package.
- Uploading PyPI packages.

### label

Manage your Repository channels.

### copy

Copy packages from one account to another.