=========
How to...
=========

.. contents::
   :local:
   :depth: 1

Use packages
============

Finding a package
-----------------

In your browser, you can search Anaconda Cloud for packages by package
name. From the top navigation bar of any page, enter the package name in
the search box. You can filter your searches to specify only conda or
PyPI packages, and you can sort results by number of favorites or number
of downloads by clicking the search results column heading.

Downloading and installing a package from Cloud
-----------------------------------------------

To install a conda package, in your terminal window run::

    conda install -c username packagename

Conda expands ``username`` to a URL such as
https://anaconda.org/username or https://conda.anaconda.org/username
based on the settings in the ``.condarc`` file.

NOTE: Replace ``username`` with your username, and ``packagename`` 
with the actual name of the package.

Downloading and installing a PyPI package from Cloud
----------------------------------------------------

To install a PyPI package, in your terminal window run::

    pip install --index-url pypi.anaconda.org/USERNAME/simple packagename

NOTE: Replace ``USERNAME`` with your username, and 
``packagename`` with the actual name of the package.

Use the Anaconda Client CLI
===========================


Installing Client
-----------------

For installation and setup instructions, see 
:ref:`Install Anaconda Client <cloud-install-client>`.


Finding my Client login credentials
-----------------------------------

Your credentials for Client are those you used to create an
account on Cloud. 

To get help:

#. Go to https://anaconda.org.

#. Select the **Sign In** tab.

#. Click either ``I forgot my password`` or ``I forgot my username``.

Logging into Client
-------------------

After you have downloaded and configured Client, open a
terminal window and run::

    anaconda login

Displaying a list of Client commands
------------------------------------

From a terminal window, run::

    anaconda --help

Finding out more about a Client command
---------------------------------------

From a terminal window, run::

    anaconda COMMANDNAME -h

NOTE: Replace ``COMMANDNAME`` with the name of the command 
about which you want more information.

Listing all available Client configuration files
------------------------------------------------

From a terminal window, run::

    anaconda config --files

Listing all of your Client configuration variables
--------------------------------------------------

From a terminal window, run::

    anaconda config --show

Finding out more about Client
-----------------------------

If you have a question that you cannot answer using the help command,
documentation or community support email group, you can `contact
Anaconda Support by email <mailto:support@anaconda.org>`_.

Build packages
==============

Building and uploading a package
--------------------------------

For a quick example, see 
:ref:`cloud-getting-started-build-upload` in :doc:`getting-started`.

Testing a built package
-----------------------

Specify the ``--use-local`` option::

    conda create --use-local -n test PACKAGENAME

NOTE: Replace PACKAGENAME with the actual name of the package.

Uploading a package to Cloud
----------------------------

In a terminal window, run::

    anaconda upload PACKAGENAME

NOTE: Replace ``PACKAGENAME`` with the actual name of the package.

Finding help for uploading packages
-----------------------------------

You can obtain a complete list of upload options, including:

* Package channel.

* Label.

* Availability to other users.

* Metadata.

To list the options, run::

    anaconda upload -h

Manage an account
=================

Getting more package storage space
----------------------------------

To upgrade to a paid plan:

#. Log into Cloud.

#. In the Profile list, select Settings.

#. Select Billing.

#. Click the Change Plan button.

For more information, see :ref:`cloud-accounts-upgrade-plan`.
