Docker ID accounts

Your free Docker ID grants you access to Docker Hub repositories and some beta programs. All you need is an email address.

Register for a Docker ID

Your Docker ID becomes your user namespace for hosted Docker services, and becomes your username on the Docker forums. To create a new Docker ID:

  1. Go to the Docker Hub signup page.

  2. Enter a username that will become your Docker ID.

    Your Docker ID must be between 4 and 30 characters long, and can only contain numbers and lowercase letters. Once you create your Docker ID you can’t reuse it in the future if you deactivate this account.

  3. Enter a unique, valid email address.

  4. Enter a password that’s at least 9 characters.

  5. Complete the Captcha verification and then select Sign up.

    Docker sends a verification email to the address you provided.

  6. Verify your email address to complete the registration process.

Note

You have limited actions available until you verify your email address.

Log in

Once you register and verify your Docker ID email address, you can sign in to Docker Hub.

You can also sign in through the CLI using the docker login command. For more information, see docker login.

Warning

When you use the docker login command, your credentials are stored in your home directory in .docker/config.json. The password is base64-encoded in this file.

We recommend using one of the Docker credential helpers for secure storage of passwords. For extra security, you can also use a personal access token to log in instead, which is still encoded in this file (without a Docker credential helper) but doesn’t allow admin actions (such as changing the password).

Troubleshooting

If you run into trouble with your Docker ID account, know that we are here to help! If you want to retrieve or reset your password, enter your email address for additional instructions.

You can use the Docker forums to ask questions amongst other Docker community members, while our hub-feedback GitHub repository allows you to provide feedback on how we can better improve the experience with Docker Hub.

If you still need any help, create a support ticket and let us know how we can help you.