How do I change my Docker username?

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.


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 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 account settings.
  2. Scroll to the bottom of the page.
  3. Click the red "deactivate account" button to deactivate your Docker account.


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.


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 account.
  3. If you created any Automated Builds, recreate them on the new account.
  4. Add any additional email addresses to the account.