=================
Command Reference
=================

Anaconda client is the command line interface (CLI) to Anaconda Repository.
It can be used for logging in, logging out, managing your account,
uploading files, generating access tokens, viewing tokens, and other
tasks. 

The full Anaconda 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 <https://api.anaconda.org/docs>`_

.. _repo-cli-anaconda:

anaconda
--------

Anaconda Repository command line manager

.. command-json-output:: anaconda --json-help

Authentication
~~~~~~~~~~~~~~

auth
^^^^

Manage Authorization Tokens

.. command-json-output:: anaconda auth --json-help

Manage Authentication tokens

See also:

-  :ref:`Using Anaconda Repository Tokens <repo-using-tokens>`


login
^^^^^

Authenticate a user

.. command-json-output:: anaconda login --json-help

whoami
^^^^^^

Print the information of the current user

.. command-json-output:: anaconda whoami --json-help

Informational
~~~~~~~~~~~~~

show
^^^^

Show information about an object

.. command-json-output:: anaconda show --json-help

Show information about an object

Examples::

    anaconda show continuumio
    anaconda show continuumio/python
    anaconda show continuumio/python/2.7.5
    anaconda show sean/meta/1.2.0/meta.tar.gz

search
^^^^^^

Search Anaconda Repository

.. command-json-output:: anaconda search --json-help

Search Anaconda Repository for packages

config
^^^^^^

Binstar configuration

.. command-json-output:: anaconda config --json-help

anaconda-client configuration

Get, Set, Remove or Show the anaconda-client configuration.

anaconda-client sites


anaconda-client sites are a mechanism to allow users to quickly switch
between Anaconda Repository instances. This is primarily used for testing the
anaconda alpha site. But also has applications for the on-site `Anaconda
Enterprise <https://www.continuum.io/anaconda-overview>`_.

anaconda-client comes with two pre-configured sites ``alpha`` and
``binstar`` you may use these in one of two ways:

-  Invoke the anaconda command with the ``-s/--site`` option like this to use
   the alpha testing site::

       anaconda -s alpha whoami

-  Set a site as the default::

       anaconda config --set default_site alpha
       anaconda whoami

Add a anaconda-client site


After installing `Anaconda
Enterprise <https://www.continuum.io/anaconda-overview>`_ you can add a site
named **site\_name** like this::

    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 - affecting all sites, or site
options - affecting only one site

By default options are set globally like this::

    anaconda config --set OPTION VALUE

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

    anaconda config --set sites.site_name.OPTION VALUE

Common anaconda-client configuration options


-  ``url``: Set the anaconda api url (default: 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 create a new package when uploading.
If no, then an upload will fail if the package name does not already
exist on the server.

::

    anaconda config --set auto_register yes|no

Managing Packages
~~~~~~~~~~~~~~~~~

package
^^^^^^^

Anaconda Repository package utilities

.. command-json-output:: anaconda package --json-help

.. _repo-cli-upload:

upload
^^^^^^

Upload packages to Anaconda Repository

.. command-json-output:: anaconda upload --json-help

::

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

See Also
''''''''

-  :ref:`Uploading a Conda Package <repo-uploading-conda-packages>`
-  :ref:`Uploading a PyPI Package <repo-uploading-pypi-packages>`


label
^^^^^

Manage your Anaconda Repository channels

.. command-json-output:: anaconda label --json-help

copy
^^^^

Copy packages from one account to another

.. command-json-output:: anaconda copy --json-help
