Convert an account into an organization

{{< summary-bar feature_name="Admin orgs" >}}

Learn how to convert an existing user account into an organization. This is useful if you need multiple users to access your account and the repositories it’s connected to. Converting it to an organization gives you better control over permissions for these users through teams and roles.

When you convert a user account to an organization, the account is migrated to a Docker Team subscription by default.

Prerequisites

Before you convert a user account to an organization, ensure that you meet the following requirements:

• The user account that you want to convert must not be a member of a company or any teams or organizations. You must remove the account from all teams, organizations, or the company.

  To do this:

  1. Navigate to My Hub and then select the organization you need to leave.
  2. Find your username in the Members tab.
  3. Select the More options menu and then select Leave organization.

  If the user account is the sole owner of any organization or company, assign another user the owner role and then remove yourself from the organization or company.

• You must have a separate Docker ID ready to assign as the owner of the organization during conversion.

  If you want to convert your user account into an organization account and you don't have any other user accounts, you need to create a new user account to assign it as the owner of the new organization. With the owner role assigned, this user account has full administrative access to configure and manage the organization. You can assign more users the owner role after the conversion.

What happens when you convert your account

The following happens when you convert your account into an organization:

• This process removes the email address for the account. Notifications are instead sent to organization owners. You'll be able to reuse the removed email address for another account after converting.
• The current subscription will automatically cancel and your new subscription will start.
• Repository namespaces and names won't change, but converting your account removes any repository collaborators. Once you convert the account, you'll need to add repository collaborators as team members.
• Existing automated builds appear as if they were set up by the first owner added to the organization.
• The user account that you add as the first owner will have full administrative access to configure and manage the organization.
• To transfer a user's personal access tokens (PATs) to your converted organization, you must designate the user as an organization owner. This will ensure any PATs associated with the user's account are transferred to the organization owner.

Convert an account into an organization

[!IMPORTANT]

Converting an account into an organization is permanent. Back up any data or settings you want to retain.

1. Sign in to Docker Home.
2. Select your avatar in the top-right corner to open the drop-down.
3. From Account settings, select Convert.
4. Review the warning displayed about converting a user account. This action cannot be undone and has considerable implications for your assets and the account.
5. Enter a Username of new owner to set an organization owner. The new Docker ID you specify becomes the organization’s owner. You cannot use the same Docker ID as the account you are trying to convert.
6. Select Confirm. The new owner receives a notification email. Use that owner account to sign in and manage the new organization.