This section describes how to create an organization. Before you begin:

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 Hub 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 Pricing 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.

  1. 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.

  1. 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.
  2. Select Purchase to continue.
  3. Enter the billing information for your organization.
  4. Select Submit to continue to the billing portal.
  5. In the billing portal, select Qty to update the number of seats you require, then select Update.
  6. (Optional) Select annual or monthly billing cycle.
  7. Follow the on-screen instructions to pay for your subscription.

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

Merge organizations#

If you have multiple organizations that you want to merge into one, complete the following:

  1. Based on the number of seats from the secondary organization, purchase additional seats for the primary organization account that you want to keep.
  2. Manually add users to the primary organization and remove existing users from the secondary organization.
  3. Manually move over your data, including all repositories.
  4. Once you're done moving all of your users and data, downgrade the secondary account to a free subscription.

[!TIP]

If your organization has a Docker Core Business subscription with a purchase order, contact Support or your Account Manager at Docker.

More resources#