.. _cloud-organizations:

==========================
Working with organizations
==========================

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

Organizations enable you to maintain group-owned repositories.

.. _creating-orgs:

Creating an organization
========================

To create an organization:

#. Log in to Anaconda Cloud.

#. In the Tools list, select Organizations, and then scroll
   to the bottom of the page.

#. Supply an organization name.

   NOTE: Organization names cannot include spaces or special
   characters.

#. Supply an email address, then click the Create Organization button.

   The system displays the dashboard for the new organization.

As the creator and owner of an organization, you have automatic
administrative access to this organization and any packages
associated with the organization.

In the Tools list, the Group Membership option shows a list of all
organizations to which you belong.


Deleting an organization
========================

To delete an organization you administer and erase all data associated
with it:

#. At the top right of the Cloud interface, in the Profile list,
   select Switch To.

#. Select the organization you want to delete.

#. In the Profile list, select Settings.

#. Select the Account option. You may be asked to verify
   your password.

#. In the Delete Account section, click the Delete button.

   A confirmation page then requests that you provide the full
   name of the organization.

.. _org-groups:

Customizing users and groups
============================

To add, remove, or edit group and user access for an organization
you administer:

#. At the top right of the Cloud interface, in the Profile list,
   select the desired organization profile.

#. In the Tools list, select Groups.

#. You can review and edit the current group and user access for
   an organization, as well as add new groups and users at
   this address: https://anaconda.org/<OrgName>/groups/

   NOTE: Replace ``<OrgName>`` with the organization name.

NOTE: Users receive a dashboard notification when you add them to
an organization.

Uploading packages to an organization
=====================================

To upload a package to an organization, use the ``-u/--user``
option and in the Terminal window or an Anaconda Prompt, run::

    anaconda upload --user ORGANIZATION package.tar.bz2

NOTE: Replace ``ORGANIZATION`` with the organization name,
and ``package.tar.bz2`` with the actual name of the package.

NOTE: Only the co-owners of an organization may upload packages
to the organization.

Creating groups for differing access levels
===========================================

Within an organization, you can create a group to customize access
for a group of users:

#. Click the +New Group button.

#. Give the group a name, and assign the desired permissions--
   Read-Only, Read-Write or Administration.

#. Add the desired members by username in the Members box.

#. Add the packages which this group can access in the Packages box.

#. Click the Save Group button.

Upgrading or downgrading an organization plan
=============================================

For instructions about changing plans, see
:ref:`cloud-accounts-upgrade-plan`.

For details about pricing, see
`our pricing <https://anaconda.org/about/pricing>`_.
