-
Notifications
You must be signed in to change notification settings - Fork 8.4k
Docker accounts refresh #25584
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Docker accounts refresh #25584
Changes from all commits
3cab0ca
7650df6
51b84ae
d01935d
b02d5d1
20a9e67
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,45 +1,62 @@ | ||
| --- | ||
| title: Docker accounts | ||
| description: Learn how to create and manage your Docker account | ||
| keywords: accounts, docker ID, account management, account settings, docker account, docker home | ||
| description: > | ||
| Learn what a Docker account is, how Docker IDs, emails, and sign-in methods | ||
| relate, and how individual accounts connect to organizations | ||
| keywords: accounts, docker ID, username, email, Google, GitHub, sign-in, | ||
| authentication, account management, docker account, individual account, | ||
| organization account, account types, Docker Hub | ||
| weight: 10 | ||
| params: | ||
| sidebar: | ||
| group: Platform | ||
| grid: | ||
| - title: Create a Docker ID | ||
| description: Get started with Docker and create an account. | ||
| icon: finger-print | ||
| link: /accounts/create-account/ | ||
| - title: Manage account | ||
| description: Learn how to manage the settings for your account. | ||
| icon: cog | ||
| link: /accounts/manage-account/ | ||
| - title: Personal access tokens | ||
| description: Learn how to create and manage access tokens for your account. | ||
| icon: lock-closed | ||
| link: /security/access-tokens/ | ||
| - title: Set up two-factor authentication | ||
| description: Add an extra layer of authentication to your Docker account. | ||
| link: /security/2fa/ | ||
| icon: device-phone-mobile | ||
| - title: Deactivate an account | ||
| description: Learn how to deactivate a Docker user account. | ||
| link: /accounts/deactivate-user-account/ | ||
| icon: no-symbol | ||
| - title: Account FAQ | ||
| description: Explore frequently asked questions about Docker accounts. | ||
| icon: question-mark-circle | ||
| link: /accounts/general-faqs/ | ||
| - title: Create an account | ||
| description: Get started with Docker and create an account. | ||
| icon: finger-print | ||
| link: /accounts/create-account/ | ||
| - title: Manage account | ||
| description: Learn how to manage the settings for your account. | ||
| icon: cog | ||
| link: /accounts/manage-account/ | ||
| - title: Personal access tokens | ||
| description: Learn how to create and manage access tokens for your account. | ||
| icon: lock-closed | ||
| link: /security/access-tokens/ | ||
| - title: Set up two-factor authentication | ||
| description: Add an extra layer of authentication to your Docker account. | ||
| link: /security/2fa/ | ||
| icon: device-phone-mobile | ||
| - title: Organization overview | ||
| description: Learn how to create and manage Docker organizations. | ||
| icon: building-storefront | ||
| link: /admin/organization/ | ||
| - title: Account FAQs | ||
| description: Explore frequently asked questions about Docker accounts. | ||
| icon: question-mark-circle | ||
| link: /accounts/general-faqs/ | ||
| --- | ||
|
|
||
| This section covers individual Docker accounts and Docker IDs. It does | ||
| not cover organizations, companies, or administrator roles. | ||
| A Docker account is how Docker identifies you. Use it to access products like | ||
| Docker Hub and Docker Desktop, manage settings, and join organizations. | ||
|
|
||
| A Docker account is required to: | ||
| - Create a Docker ID | ||
| - Access Docker products and services like Docker Hub and Docker Desktop | ||
| - Receive organization invitations | ||
| - Manage your personal settings and security features | ||
| Docker has two primary account types: individual and organization. You create | ||
| and administer organizations with your individual account. For organization | ||
| accounts, see [Organizations](/manuals/admin/organization/_index.md). For | ||
| organizations and companies, see [Administration](/manuals/admin/_index.md). | ||
|
|
||
| ## Docker ID, email, and sign-in | ||
|
|
||
| When you create an account, you choose a Docker ID and a sign-in method. | ||
| Docker also ties a verified email to the account. | ||
|
|
||
| - Docker account: Associates your plans, Hub repositories, and account | ||
| settings. | ||
| - Docker ID: A unique username that identifies you. | ||
| - Email: How Docker contacts you for notifications and security-related | ||
| communications. | ||
| - Sign-in method: Email and password, Google, or GitHub. | ||
|
|
||
| ## What's next | ||
|
|
||
| {{< grid >}} | ||
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -1,83 +1,98 @@ | ||||||
| --- | ||||||
| title: Create a Docker account | ||||||
| linkTitle: Create an account | ||||||
| linkTitle: Create | ||||||
| weight: 10 | ||||||
| description: Learn how to register for a Docker ID and sign in to your account | ||||||
| description: Create a Docker ID with email, Google, or GitHub, then sign in | ||||||
| keywords: | ||||||
| accounts, docker ID, billing, paid plans, support, Hub, Store, Forums, knowledge | ||||||
| base, beta access, email, activation, verification | ||||||
| create docker account, docker ID, sign up, sign in, email, Google, GitHub, | ||||||
| verification, OTP, password reset, docker login | ||||||
| aliases: | ||||||
| - /docker-hub/accounts/ | ||||||
| - /docker-id/ | ||||||
| --- | ||||||
|
|
||||||
| You can create a free Docker account with your email address or by signing up | ||||||
| with your Google or GitHub account. After creating a unique Docker ID, you can | ||||||
| access all Docker products, including Docker Hub, Docker Desktop, and Docker Scout. | ||||||
| access Docker products, including Docker Hub, Docker Desktop, and Docker Scout. | ||||||
|
|
||||||
| Your Docker ID becomes your username for hosted Docker services, and | ||||||
| Your Docker ID becomes your username for hosted Docker services and | ||||||
| [Docker forums](https://forums.docker.com/). | ||||||
|
|
||||||
| > [!TIP] | ||||||
| > | ||||||
| > Explore [Docker's subscriptions](https://www.docker.com/pricing?ref=Docs&refAction=DocsCreateAccount) to see what else Docker can offer you. | ||||||
| > Explore | ||||||
| > [Docker's subscriptions](https://www.docker.com/pricing?ref=Docs&refAction=DocsCreateAccount) | ||||||
| > to see what else Docker can offer you. | ||||||
|
|
||||||
| ## Create and verify your account | ||||||
|
|
||||||
| Signing up with an email address, Google, or GitHub account requires additional verification to complete account creation: | ||||||
| Signing up with an email address, Google, or GitHub requires verification | ||||||
| before you can sign in: | ||||||
|
|
||||||
| - If you sign up with Google or GitHub, you must first verify your email address with that provider. | ||||||
| - If you sign up with an email address, you need to follow verification steps. | ||||||
| - After creating an account, Docker asks for a one-time password (OTP). | ||||||
| - Find the email from Docker with your code, then return to the OTP page to paste in your OTP code. | ||||||
| - If you sign up with Google or GitHub, verify your email address with that | ||||||
| provider first. | ||||||
| - If you sign up with an email address, Docker sends a one-time password | ||||||
| (OTP). Enter the code from the Docker email on the OTP page. | ||||||
|
|
||||||
| Docker blocks sign-in until you've verified your account. | ||||||
|
|
||||||
| ### Sign up with your email | ||||||
| {{< tabs >}} | ||||||
| {{< tab name="Email" >}} | ||||||
|
|
||||||
| 1. Go to the [Docker sign-up page](https://app.docker.com/signup/) and enter a unique, valid email address. | ||||||
| 1. Enter a username to use as your Docker ID. Once you create your Docker ID | ||||||
| you can't reuse it in the future if you deactivate this account. Your username: - Must be between 4 and 30 characters long - Can only contain numbers and lowercase letters | ||||||
| 1. Choose a password that's at least 9 characters long, then select **Sign Up**. | ||||||
| 1. Verify your email address when you receive the Docker OTP verification email. This completes the registration process. | ||||||
| 1. Go to the [Docker sign-up page](https://app.docker.com/signup/) and enter a | ||||||
| unique, valid email address. | ||||||
| 1. Enter a username to use as your Docker ID. Once you create your Docker ID, | ||||||
| you can't reuse it if you deactivate this account. Your username: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
| - Must be between 4 and 30 characters long | ||||||
| - Can only contain numbers and lowercase letters | ||||||
| 1. Choose a password that's at least 9 characters long, then select | ||||||
| **Sign up**. | ||||||
| 1. Verify your email address when you receive the Docker OTP verification | ||||||
| email. This completes the registration process. | ||||||
|
|
||||||
| ### Sign up with Google or GitHub | ||||||
| {{< /tab >}} | ||||||
| {{< tab name="Google or GitHub" >}} | ||||||
|
|
||||||
| 1. Go to the [Docker sign-up page](https://app.docker.com/signup/). | ||||||
| 1. Select your social provider, Google or GitHub. | ||||||
| 1. Select the social account you want to link to your Docker account. | ||||||
| 1. Select **Authorize Docker** to let Docker access your social account | ||||||
| information. You will be re-routed to the sign-up page. | ||||||
| information. Docker redirects you to the sign-up page. | ||||||
| 1. Enter a username to use as your Docker ID. Your username: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We should probably have the same username disclaimers that we have on lines 44-45 |
||||||
| - Must be between 4 and 30 characters long | ||||||
| - Can only contain numbers and lowercase letters | ||||||
| 1. Select **Sign up**. | ||||||
|
|
||||||
| {{< /tab >}} | ||||||
| {{< /tabs >}} | ||||||
|
|
||||||
| ## Sign in to your account | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. i think we should consider removing this entire ## Sign in to your account section |
||||||
|
|
||||||
| You can sign in with your email, Google or GitHub account, or from | ||||||
| the Docker CLI. | ||||||
| You can sign in with your email, Google or GitHub account, or from the Docker | ||||||
| CLI. | ||||||
|
|
||||||
| ### Sign in with email or Docker ID | ||||||
| {{< tabs >}} | ||||||
| {{< tab name="Email or Docker ID" >}} | ||||||
|
|
||||||
| 1. Go to the [Docker sign in page](https://login.docker.com). | ||||||
| 1. Go to the [Docker sign in page](https://login.docker.com/). | ||||||
| 1. Enter your email address or Docker ID and select **Continue**. | ||||||
| 1. Enter your password and select **Continue**. | ||||||
|
|
||||||
| To reset your password, see [Reset your password](#reset-your-password). | ||||||
|
|
||||||
| ### Sign in with Google or GitHub | ||||||
| {{< /tab >}} | ||||||
| {{< tab name="Google or GitHub" >}} | ||||||
|
|
||||||
| You can sign in using your Google or GitHub credentials. If your social | ||||||
| account uses the same email address as an existing Docker ID, the | ||||||
| accounts are automatically linked. | ||||||
| account uses the same email address as an existing Docker ID, Docker links | ||||||
| that provider to the account. | ||||||
|
|
||||||
| If no Docker ID exists, Docker creates a new account for you. | ||||||
|
|
||||||
| Docker doesn't support linking multiple sign-in methods | ||||||
| to the same Docker ID. | ||||||
| You can't link both Google and GitHub to the same Docker ID. | ||||||
|
|
||||||
| ### Sign in using the CLI | ||||||
| {{< /tab >}} | ||||||
| {{< tab name="CLI" >}} | ||||||
|
|
||||||
| Use the `docker login` command to authenticate from the command line. For | ||||||
| details, see [`docker login`](/reference/cli/docker/login/). | ||||||
|
|
@@ -89,9 +104,13 @@ details, see [`docker login`](/reference/cli/docker/login/). | |||||
| > | ||||||
| > To improve security, use | ||||||
| > [Docker credential helpers](https://github.com/docker/docker-credential-helpers). | ||||||
| > For even stronger protection, use a [personal access token](../security/access-tokens.md) | ||||||
| > instead of a password. This is especially useful in CI/CD environments | ||||||
| > or when credential helpers aren't available. | ||||||
| > For even stronger protection, use a | ||||||
| > [personal access token](../security/access-tokens.md) instead of a password. | ||||||
| > This is especially useful in CI/CD environments or when credential helpers | ||||||
| > aren't available. | ||||||
|
|
||||||
| {{< /tab >}} | ||||||
| {{< /tabs >}} | ||||||
|
|
||||||
| ## Reset your password | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Same as above, I don't think we need a docs section explaining the pw reset flow |
||||||
|
|
||||||
|
|
@@ -104,11 +123,12 @@ To reset your password: | |||||
| ## Troubleshooting | ||||||
|
|
||||||
| If you have a paid Docker subscription, | ||||||
| [contact the Support team](https://hub.docker.com/support/contact/) for assistance. | ||||||
| [contact the Support team](https://hub.docker.com/support/contact/) for | ||||||
| assistance. | ||||||
|
|
||||||
| All Docker users can seek troubleshooting information and support through the | ||||||
| following resources, where Docker or the community respond on a best effort | ||||||
| following resources, where Docker or the community respond on a best-effort | ||||||
| basis: | ||||||
|
|
||||||
| - [Docker Community Forums](https://forums.docker.com/) | ||||||
| - [Docker Community Slack](http://dockr.ly/comm-slack) | ||||||
| - [Docker Community Slack](https://dockr.ly/comm-slack) | ||||||
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.