=====================
Managing Your Account
=====================

Personal accounts
=================


Overview
~~~~~~~~

This section explains how to create a free or personal account, log in
and out, and access the settings and features of different types of
accounts.

Create free account
~~~~~~~~~~~~~~~~~~~

**Free account features**

All Anaconda Cloud users can find, download and use packages without
creating a subscriber account. Subscribers can upload packages,
notebooks and environments, and they get a 4-node cluster license free
of charge. They can also create organizations.

You'll need to create an Anaconda Cloud account to:

-  author packages
-  access shared private packages

To sign up for a free account:

-  In a browser, go to `Anaconda Cloud <http://anaconda.org>`__.
-  Make sure the Sign Up tab is active. NOTE: There's also a Sign In tab
   for existing users.

|Anaconda Cloud home page|

-  Select a username.
-  Enter your email address. NOTE: Users who register with an .edu email
   are granted a few additional features.
-  Create a password. NOTE: The password must be at least 7 characters
   long.
-  Enter the password again to confirm it.
-  Read and accept the Terms and Conditions.
-  Click the Sign up button. The system creates your free account, logs
   you in, and displays your personal Dashboard.

TIP: Anaconda Cloud displays your profile photo if the email address you
used to register on Anaconda Cloud is associated with a Gravatar
account. Go to `gravatar.com <http://gravatar.com>`__ to associate your
email address or to change your Gravatar profile photo.

While you're logged into Anacond Cloud the Profile pull-down menu will
appear at the top right of every page. This indicates the name of the currently 
active user or organization.

|Anaconda Cloud user toolbar|

The left most button is the Tools pull-down menu. The Tools menu contains the following options:

#. Landscape - Your home page.
#. View All - All packages, notebooks and environments you have created.
#. Packages - Only packages you have created.
#. Notebooks - Only notebooks you have created.
#. Environments - Only environments you have created.
#. Favorites - Packages from other users you have starred
#. Organizations - Link to create a new organization
#. Group Membership - If you are part of an organization, the groups you can access.
#. Labels - Labels you have created, for example test or development. See 
   documentation for additional information.

|Anaconda Cloud toolbar menu|

Packages, notebooks and environments that you have created with this account 
appear on your Dashboard. 

See Also: :ref:`Working with Packages <using-packages>`


Reset password
~~~~~~~~~~~~~~

The Sign In screen offers two links to help regain access to your
account:

-  **I forgot my username.** Click this link to have the username
   emailed to the email address of record.
-  **I forgot my password.** Click this link to have a reset password
   link sent to the email address of record. NOTE: The reset password
   link expires within 24 hours. If you no longer have access to the
   email account, you can create a new account or email
   `support@continuum.io <mailto:support@continuum.io>`__ for
   assistance.

.. _upgrade-plan:

Upgrade or downgrade plan
~~~~~~~~~~~~~~~~~~~~~~~~~

-  Log in to your Anaconda Cloud account.
-  Select My Settings from the Profile pull-down menu.
-  Select Billing.
-  Click the Change Plan button. The system displays detailed
   information about your plan.

NOTE: If you need more private packages or storage space than is
included in the Personal plan, `contact Continuum
Analytics <https://www.continuum.io/contact-us>`__ so we can customize a
plan for you.

NOTE: If you need assistance with billing questions, please `contact
Continuum Analytics <https://www.continuum.io/contact-us>`__.

.. _using-tokens:

Create Access Tokens
~~~~~~~~~~~~~~~~~~~~

You can use tokens to control access to private repositories,
collections, or packages on Anaconda Cloud. Additionally, the degree of
access a token grants is completely configurable at the time of
generation.

Multiple tokens can be generated to control which groups
of users have access to certain features if they have the
appropriate token.


Generating tokens
^^^^^^^^^^^^^^^^^

Tokens can be generated using the Anaconda client or the Web UI.

Using the Web UI navigate to::

    https://anaconda.org/<channel>/settings/access

From here you can select a name for the token and set the required scopes.

|Anaconda Cloud tokens|

By default tokens will expire after one year.


To generate a token with Anaconda client::

      anaconda auth --create --name YOUR-TOKEN-NAME --scopes 'repos conda:download'

This generates a random alphanumeric token string, which you can then
distribute to fellow Anaconda Cloud users to enable them to download a
package that you have marked private. The token produced in this example
provides access to download any of your private conda repositories. It
can be enabled with the ``conda config`` command::

      conda config --add channels https://conda.anaconda.org/t/<token>/<channel>

*NOTE: A pre-existing token cannot be regenerated. You will have revoke the token
and create a new one if you lose the random alphanumeric string.*

Scopes are provided as a space separated quoted list. The available scopes are

- ``all``: Allow all operations
- ``api``: Allow all API operations
- ``api:modify-group``: Allow addition and modification of groups
- ``api:read``: Allow read access to the API site
- ``api:write``: Allow write access to the API site
- ``conda``: Allow all operations on Conda repositories
- ``conda:download``: Allow private downloads from Conda repositories
- ``pypi``: Allow all operations on PyPI repositories
- ``pypi:download``: Allow private downloads from PyPI repositories
- ``pypi:upload``: Allow uploads to PyPI repositories
- ``repos``: Allow access to all package repositories

*NOTE: Tokens provide access to ALL packages within a specified channel. Separate
permissions per package, notebook or environment may be better handled with*
:ref:`Organizations <creating-orgs>` *and* :ref:`Groups <org-groups>`.

Revoking tokens
^^^^^^^^^^^^^^^

Tokens can be revoked from the following URL::

    https://anaconda.org/<channel>/settings/access

or by using Anaconda client::

    anaconda auth -r YOUR-TOKEN-NAME


Academic Accounts
=================

Overview
~~~~~~~~

Anaconda Cloud is free for academic users. Users who subscribe to
Anaconda Cloud with an email address from an .edu domain are
automatically granted access to add-ons, including IOPro, MKL and
Anaconda Accelerate.

If you need assistance with an academic account, email us at
`support@continuum.io <mailto:support@continuum.io>`__.


Organization Accounts
=====================

Subscribers - in both free and paid accounts - can create Anaconda Cloud
organizations. Create an organization to:

-  Share packages, environments or notebooks under an organization's
   account rather than your personal account
-  Assign multiple account administrators
-  Assign different access permissions to groups of users and customize
   per-package access by group
-  Host more, larger packages. See `our
   pricing <https://anaconda.org/about/pricing>`__ for details.


Free vs. paid Organization Features
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In a free plan, organizations have the following limitations:

-  No private packages allowed

In a paid plan, organizations can:

-  Host up to 100 private packages
-  Use up to 100 GB of Storage

See `our pricing <https://anaconda.org/about/pricing>`__ for details.

.. |Anaconda Cloud home page| image:: /img/cloud-home.png
.. |Anaconda Cloud user toolbar| image:: /img/managing-toolbar-bar.png
.. |Anaconda Cloud toolbar menu| image:: /img/managing-toolbar-menu.png
.. |Anaconda Cloud tokens| image:: /img/cloud-tokens.png
