.. _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::

    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>`_.
