Skip to main content

Docker Success Center

The Docker enterprise customer portal.

Docker, Inc.

How do I change my Docker Hub username?


How do I change my Docker Hub username?


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.


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.


Once you have completed the preparation steps, send an email to 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.


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.