0 0 Share PDF

How do I change my Docker username?

Article ID: KB000295

To change your Docker username, make a copy of your existing images, deactivate your old username, create a new Docker username, and restore your images and Automatic Builds to your new Docker account.

Preparation

Before deactivating your old username:

  1. Download any images (and tags) you wish to keep by running the following command: docker pull -a <image>
  2. 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.
  3. If you belong to an organization, remove yourself from the organization.
  4. 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.
  5. Unlink your Github and Bitbucket accounts.

Once you've completed the steps above:

  1. Go to your Docker Hub account settings.
  2. Scroll to the bottom of the page.
  3. Click the red "deactivate account" button to deactivate your Docker Hub account.

Renaming

Docker Support will deactivate your account, remove the associated email addresses, and notify you when you can create a new account. Once your email address has been removed from the old account, you may then proceed with creating a new account using that email address.

Repopulating

After creating your new account, you can restore images and add additional email addresses to the account.

  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.
  4. Add any additional email addresses to the account.