Skip to main content

Docker Success Center

The Docker enterprise customer portal.

Docker, Inc.

How do I change my Docker Hub username?

Question

How do I change my Docker Hub username?

Answer

To change your Docker Hub username, make a copy of your existing images, request the new Docker Hub username, and restore your images and Automatic Builds to your new Docker Hub account.

Preparation

Before requesting a different Docker Hub username:

  1. Download any images (and tags) you wish to keep by running the following command: docker pull -a <image>

  2. Delete all repositories associated with your account.

  3. If you have an active Docker subscription, downgrade to the free plan.

  4. If you have a license key, download the key from your Docker Hub account. The download link will no longer be available after the rename.

  5. If you belong to an organization, remove yourself from the organization.
  6. If you are the sole owner of an organization, either remove yourself from the organization or add someone to the "owners" team and then remove yourself from the organization.

Renaming

Once you have completed the preparation steps, send an email to support@docker.com asking to have your account renamed or open a Customer Service Request using the email address associated with the account and provide the Docker ID of the account you wish to rename.

Repopulating

After your account has been renamed:

  1. Run docker tag for all of your images with your new account name.
  2. Run docker push for each of your images to push to your new Docker Hub account.
  3. If you created any Automated Builds, recreate them on the new account.