Create your organization

An organization in Docker is a collection of teams and repositories that can be managed together. A team is a group of Docker members that belong to an organization. An organization can have multiple teams. Members don't have to be added to a team to be part of an organization.

Docker users become members of an organization once they're associated with that organization by an organization owner. An organization owner is a user with administrative access to the organization.

Owners can invite users, assign them roles, create new teams, and add members to an existing team using their Docker ID or email address. An organization owner can also add additional owners to help them manage users, teams, and repositories in the organization.

The following diagram depicts the setup of an organization and how it relates to teams. Teams are an optional feature that owners can use to group members and assign permissions.

Create an organization

There are multiple ways to create an organization. You can create a brand new organization using the Create Organization option in Docker Hub, or you can convert an existing user account to an organization. The following section contains instructions on how to create a new organization. For prerequisites and detailed instructions on converting an existing user account to an organization, see Convert an account into an organization.

To create an organization:

1. Sign in to Docker Hubopen_in_new using your Docker ID, your email address, or your social provider.

2. Select Organizations and then Create Organization to create a new organization.

3. Choose a plan for your organization and select Buy Now. See Docker Pricingopen_in_new for details on the features offered in the Team and Business plan.

   Note

   Selecting Buy Now isn't an obligation to pay. You can complete this step without incurring a payment.

4. Enter a name for your organization. This is the official, unique name for your organization in Docker Hub. It's not possible to change the name of the organization after you've created it.

   Note

   You can't use the same name for the organization and your Docker ID. If you want to use your Docker ID as the organization name, then you must first convert your account into an organization.

5. Enter the name of your company. This is the full name of your company. Docker displays the company name on your organization page and in the details of any public images you publish. You can update the company name anytime by navigating to your organization's Settings page.

6. Select Purchase to continue to the billing portal.

7. In the billing portal, select Qty to update the number of seats you require, then select Update.

8. (Optional) Select annual or monthly billing cycle.

9. Follow the on-screen instructions to pay for your subscription.

   Note

   If you've already paid for a subscription for the new organization through a Docker sales representative, then don't enter payment information. Instead, select Back to return to Docker Hub from the billing portal, then select Organizations to verify that the organization has been created.

You've now created an organization.

View an organization

To view an organization:

1. Sign in to Docker Hub with a user account that is a member of any team in the organization.

   Note

   You can't directly log in to an organization. This is especially important to note if you create an organization by converting a user account, as conversion means you lose the ability to log into that "account", since it no longer exists. To view the organization you need to log in with the new owner account assigned during the conversion or another account that was added as a member. If you don't see the organization after logging in, then you are neither a member or an owner of it. An organization administrator needs to add you as a member of the organization.

2. Select Organizations in the top navigation bar, then choose your organization from the list.

The organization landing page displays various options that allow you to configure your organization.

• Members: Displays a list of team members. You can invite new members using the Invite members button. See Manage members for details.

• Teams: Displays a list of existing teams and the number of members in each team. See Create a team for details.

• Repositories: Displays a list of repositories associated with the organization. See Repositories for detailed information about working with repositories.

• Activity Displays the audit logs, a chronological list of activities that occur at organization and repository levels. It provides the org owners a report of all their team member activities. See Audit logs for details.

• Settings: Displays information about your organization, and allows you to view and change your repository privacy settings, configure org permissions such as Image Access Management, configure notification settings, and deactivate your organization. You can also update your organization name and company name that appear on your organization landing page. You must be an owner to access the organization's Settings page.

• Billing: Displays information about your existing Docker subscription (plan), including the number of seats and next payment due date. For how to access the billing history and payment methods for your organization, see View billing history.

Videos

You can also check out the following videos for information about creating Teams and Organizations in Docker Hub.

• Overview of organizationsopen_in_new
• Create an organizationopen_in_new
• Working with Teamsopen_in_new
• Create Teamsopen_in_new