nprasad2077/docker-docs
1
0 Fork 0
mirror of https://github.com/docker/docs.git synced 2026-11-04 10:01:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: refresh individual account docs (#26384)

Browse Source 
## Summary

Refresh the Accounts and Individual account pages so signup, manage, and
deactivate flows use task-oriented headings, UI-matched steps, and
agent-relevant facts (permanent Docker ID, Work/Personal signup,
connect-provider email match). Replaces tabbed create-account content
and stub manage-account sections that flattened poorly in markdown.

@netlify /accounts/individual/

### Preview

- https://deploy-preview-26384--docsdocker.netlify.app/accounts/
-
https://deploy-preview-26384--docsdocker.netlify.app/accounts/individual/
-
https://deploy-preview-26384--docsdocker.netlify.app/accounts/individual/create-account/
-
https://deploy-preview-26384--docsdocker.netlify.app/accounts/individual/manage-account/
-
https://deploy-preview-26384--docsdocker.netlify.app/accounts/individual/deactivate-user-account/

Generated by Cursor

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Alexa KristensenandCursor authored and GitHub committed 2026-10-20 09:19:31 -05:00
1 parent fea36e9fcc
commit 5bd4f66c63
5 files changed
+178 -206
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

content/manuals/accounts/_index.md
+3 -4
View File
@@ -37,9 +37,8 @@ grid:
---
A Docker account identifies you and lets you access Docker products. You
manage it in [Docker Home](https://app.docker.com/). Docker has two
primary account types: individual and organization. A company groups
multiple organizations.
manage your Docker accounts in [Docker Home](https://app.docker.com/).
Docker offers individual, organization, and company account types.
| Account type | What it is | Who it's for |
| --- | --- | --- |
@@ -48,7 +47,7 @@ multiple organizations.
| Company | Shared sign-in and administration for organizations that keep their own members, repositories, and billing | Docker Business subscribers |
You always sign in with your individual account, then work in the
organizations you own or belong to.
organizations or companies you own or belong to.
## Next steps
content/manuals/accounts/individual/_index.md
+32 -25
View File
@@ -2,35 +2,36 @@
title: Docker individual accounts
linkTitle: Individual
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, SSO, deactivate account
What a Docker account is, how a Docker ID relates to your email and
sign-in method, and how the account connects to an organization
keywords: Docker ID, username, email, Google, GitHub, sign-in,
authentication, individual account, organization account, organization
namespace, convert account, Docker Hub, Docker Desktop, SSO, deactivate
account
weight: 10
grid:
- title: Set up your account
description: Get started with Docker and create an account.
description: Create a Docker account with email, Google, or GitHub.
icon: finger-print
link: /accounts/individual/create-account/
- title: Manage account
description: Learn how to manage the settings for your account.
description: Update your profile, email, password, and connected accounts.
icon: cog
link: /accounts/individual/manage-account/
- title: Personal access tokens
description: Learn how to create and manage access tokens for your account.
description: Create and manage personal access tokens.
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/authentication/2fa/manage/
- title: Manage two-factor authentication
description: Turn two-factor authentication on or off.
icon: device-phone-mobile
link: /security/authentication/2fa/manage/
- title: Organization accounts
description: Learn how to create and manage Docker organizations.
description: Create and manage organization accounts.
icon: building-storefront
link: /accounts/organization/
- title: Account FAQs
description: Explore frequently asked questions about Docker accounts.
description: Common questions about Docker accounts.
icon: question-mark-circle
link: /faqs/accounts/
---
@@ -38,24 +39,30 @@ grid:
A Docker account is how Docker identifies you. Use it to access products like
Docker Hub and Docker Desktop, manage settings, and join organizations.
For how individual, organization, and company accounts compare, see
[Accounts](/manuals/accounts/_index.md). For organization accounts, including
companies, see
[Organization accounts](/manuals/accounts/organization/_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
- Your 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,
[single sign-on (SSO)](/manuals/security/authentication/single-sign-on/_index.md),
Google, or GitHub.
- A Docker ID is a unique username that identifies you. Your Docker ID is
permanent and stays the same when you change your email or sign-in
method.
- Your email is how Docker contacts you for notifications and
security-related communications.
- You can sign in with email and password, Google, or GitHub. An
organization or company you belong to can require
[single sign-on (SSO)](/manuals/security/authentication/single-sign-on/_index.md).
## Individual and organization accounts
When you join an organization, you use your individual account and its
Docker ID. To learn more about organization accounts, see
[Organization accounts](/manuals/accounts/organization/_index.md). To
transfer your Docker ID to an organization namespace, see
[Convert a Docker account to an
organization](/manuals/accounts/organization/setup/convert-account.md).
## Next steps
content/manuals/accounts/individual/create-account.md
+44 -53
View File
@@ -6,83 +6,74 @@ description: Create a Docker ID with email, Google, or GitHub, then verify your
account
keywords:
create docker account, docker ID, sign up, sign in, email, Google, GitHub,
verification, OTP, password, docker login, username requirements
Work, Personal, verification, OTP, password, docker login, username
requirements
aliases:
- /accounts/create-account/
- /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 Docker products, including Docker Hub, Docker Desktop, and Docker Scout.
Your Docker ID becomes your username for hosted Docker services and
You can create a Docker account with email, Google, or GitHub. Creating an
account gives you a Docker ID, which is your username for Docker Hub,
Docker Desktop, Docker Scout, and
[Docker forums](https://forums.docker.com/).
> [!TIP]
>
> See
> [Docker's subscriptions](https://www.docker.com/pricing?ref=Docs&refAction=DocsCreateAccount)
> for available plans.
> Ready to move from Docker Personal to Docker Pro?
> [Upgrade your subscription](https://www.docker.com/pricing?ref=Docs&refAction=DocsCreateAccount).
## Create and verify your account
Signing up with an email address, Google, or GitHub requires verification
before you can sign in:
Every sign-up path requires verification before you can sign in. Docker
blocks sign-in until you've verified your account.
- 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.
### Email
Docker blocks sign-in until you've verified your account.
{{< 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. After you create your Docker
ID, you can't change it or reuse it 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.
{{< /tab >}}
{{< tab name="Google or GitHub" >}}
Create an account with an email address and password, then verify with a
six-digit code Docker emails you.
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. Docker redirects you to the sign-up page.
1. Enter a username to use as your Docker ID. After you create your Docker
ID, you can't change it or reuse it if you deactivate this account. Your
username:
1. Select **Work** or **Personal**, then enter a unique, valid email address.
1. Enter a username to use as your Docker ID. Your Docker ID is permanent.
Your username:
- Must be between 4 and 30 characters long
- Can only contain numbers and lowercase letters
1. Select **Sign up**.
- Can only contain letters and numbers. Docker stores it in lowercase.
- Must not be an email address
1. Choose a password between 9 and 128 characters long, then select
**Sign up**.
1. Enter the six-digit code from the Docker verification email. This
completes the registration process.
{{< /tab >}}
{{< /tabs >}}
### Google or GitHub
Create an account with Google or GitHub. Docker uses the email on that
provider account, and you do not set a Docker password during sign-up.
Verify that email with the provider before you continue.
1. Go to the [Docker sign-up page](https://app.docker.com/signup/).
1. Select **Continue with Google** or **Continue with GitHub**.
1. Select the social account you want to link to your Docker account.
1. Authorize Docker to access your social account information. Docker
redirects you to the sign-up page.
1. Enter a username to use as your Docker ID. Your Docker ID is permanent.
Your username:
- Must be between 4 and 30 characters long
- Can only contain letters and numbers. Docker stores it in lowercase.
- Must not be an email address
1. Select **Sign up**.
## Troubleshooting
All Docker users can find troubleshooting help through the
[Docker Community Forums](https://forums.docker.com/) and the
[Docker Community Slack](https://dockr.ly/comm-slack). Docker or the
community respond on a best-effort basis.
If you have a paid Docker subscription,
[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
basis:
- [Docker Community Forums](https://forums.docker.com/)
- [Docker Community Slack](https://dockr.ly/comm-slack)
help.
## Next steps
content/manuals/accounts/individual/deactivate-user-account.md
+20 -31
View File
@@ -5,45 +5,35 @@ weight: 30
description: Prerequisites and steps to deactivate an individual Docker account
keywords:
deactivate docker account, delete docker account, close docker account,
disable docker account, account management, leave organization, privacy
request, personal data
disable docker account, account management, leave organization, backup
repositories, privacy request, personal data
aliases:
- /accounts/deactivate-user-account/
---
Learn how to deactivate an individual Docker account, including the
prerequisites required for deactivation.
For information on deactivating an organization, see
[Deactivate an organization](/manuals/accounts/organization/manage/deactivate-account.md).
When you deactivate an individual Docker account, Docker removes all of
your public and private repositories. All Docker products and services
that use your Docker account are inaccessible after deactivation.
> [!WARNING]
>
> All Docker products and services that use your Docker account are
> inaccessible after deactivating your account.
> Back up any important data before you continue. Deactivating your account is
> permanent and cannot be undone.
## Prerequisites
## Before you deactivate
Before deactivating your Docker account, complete the following
requirements:
- If you are an organization or company owner, you must leave your
organization or company before deactivating your Docker account:
1. Sign in to [Docker Home](https://app.docker.com/admin) and choose your
organization.
1. Select **Members** and find your username.
1. Select the **Actions** menu and then select **Leave organization**.
- If you are the sole owner of an organization, you must assign the owner
role to another member of the organization and then remove yourself from
the organization, or deactivate the organization. Similarly, if you are
the sole owner of a company, either add someone else as a company owner
and then remove yourself, or deactivate the company.
- If you are an organization or company owner, you must [leave your
organization or
company](/manuals/accounts/organization/setup/convert-account.md#leave-an-existing-organization)
before deactivating your Docker account.
- If you have an active Docker subscription,
[downgrade it to a Docker Personal
subscription](/manuals/subscription-billing/plans/docker.md#cancel-a-docker-plan).
- Download any images and tags you want to keep. Use
`docker pull -a <image>` to pull all tags, or `docker pull <image>:<tag>`
to pull a specific tag.
This includes paid Docker Scout and Docker Build Cloud plans.
- Pull any images and tags you want to keep.
- If you linked a GitHub or Bitbucket account for automated builds, unlink
it. See
[Unlink a GitHub user
@@ -54,18 +44,17 @@ requirements:
## Deactivate
After you complete the prerequisites, you can deactivate your account.
> [!WARNING]
>
> Deactivating your account is permanent and can't be undone. Make sure
> to back up any important data.
The **Deactivate account** button stays unavailable until you complete
the deactivation requirements.
1. Sign in to [Docker Home](https://app.docker.com/login).
1. Select your avatar to open the drop-down menu.
1. Select **Account settings**.
1. Select **Deactivate**.
1. Select **Deactivate account**, then select again to confirm.
1. Enter your username in the **User account** field.
1. Select **Deactivate account**.
Docker signs you out after it deactivates your account.
## Delete personal data
content/manuals/accounts/individual/manage-account.md
+79 -93
View File
@@ -2,131 +2,117 @@
title: Manage a Docker account
linkTitle: Manage
weight: 20
description: Update account settings, email, password, 2FA, tokens, and
connected accounts
description: Update your profile, email, password, and connected Google or
GitHub accounts
keywords:
manage docker account, account settings, update email, change password,
Gravatar, two-factor authentication, personal access tokens, Google, GitHub,
connected accounts, convert account, deactivate account, Docker Home
manage docker account, account settings, account information, full name,
update email, verify email, change password, reset password, Google,
GitHub, connected accounts, two-factor authentication, personal access
tokens, convert account, deactivate account, Docker Home
aliases:
- /accounts/manage-account/
---
You can manage your Docker account in Docker Home, including administrative
and security settings.
> [!TIP]
>
> If your account is associated with an organization that enforces single
> sign-on (SSO), you may not have permissions to update your account settings.
> Contact your administrator to update your settings.
Update your profile, email, password, and Google or GitHub sign-in.
## Update account information
Account information is visible on your **Account settings** page. You can
update the following:
Other Docker users can see your account information.
- Full name
- Company
- Location
- Website
- Gravatar email
To add or update your avatar using Gravatar:
1. Create a [Gravatar account](https://gravatar.com/).
1. Create your avatar.
1. Add your Gravatar email to your Docker account settings.
It may take some time for your avatar to update in Docker.
1. Sign in to [Docker Home](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select
**Account settings**.
1. Select **Account information**.
1. Update any of these fields, then select **Save**:
- **Full name**
- **Company**
- **Location**
- **Website**
- **Gravatar email**
## Update email address
To update your email address:
A Docker account has one verified email address. If your account uses
single sign-on (SSO) or System for Cross-domain Identity Management
(SCIM) provisioning, contact your administrator to change your email.
1. Sign in to your [Docker account](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select **Account settings**.
1. Sign in to [Docker Home](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select
**Account settings**.
1. Select **Email**.
1. Enter your new email address and confirm your identity with your password.
Select **Verify email**.
1. Go to the new Docker email and copy the 6-digit verification code.
1. Paste the verification code to complete updating your email.
Your verification session expires after 15 minutes.
> [!NOTE]
>
> Docker accounts only support one verified email address at a time, which
> is used for account notifications and security-related communications. You
> can't add multiple verified email addresses to your account.
1. Enter the new address in **New email address**.
1. Enter your password in **Enter your password to confirm**.
1. Select **Verify email**.
1. Enter the six-digit code in **Enter code**. The code expires after 15
minutes.
1. Sign in again to finish the update.
## Change your password
Initiate your password reset through email:
If your account uses single sign-on (SSO), contact your administrator to
change your password.
1. Sign in to your [Docker account](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select **Account settings**.
1. Select **Password**, then **Reset password**.
1. Docker sends you a password reset email with instructions to reset your
password.
1. Sign in to [Docker Home](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select
**Account settings**.
1. Select **Password**.
1. Select **Reset password**.
## Manage two-factor authentication
Docker emails you instructions to reset your password.
To update your two-factor authentication (2FA) settings:
1. Sign in to your [Docker account](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select **Account settings**.
1. Select **2FA**.
For more information, see
[Enable two-factor authentication](/manuals/security/authentication/2fa/manage.md).
## Manage personal access tokens
To manage personal access tokens:
1. Sign in to your [Docker account](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select **Account settings**.
1. Select **Personal access tokens**.
For more information, see
[Create and manage access tokens](/manuals/security/access-tokens/personal-access-tokens.md).
You can also
[update or delete personal access tokens](/manuals/security/access-tokens/personal-access-tokens.md#update-or-delete)
and
[update your two-factor authentication](/manuals/security/authentication/2fa/manage.md#disable-two-factor-authentication).
## Manage connected accounts
If you signed up with Google or GitHub, that provider appears under
**Connected accounts**. Disconnecting it removes the OAuth connection. It
doesn't change your Docker ID, and it doesn't let you add a different sign-in
method. You can't connect both Google and GitHub to the same account.
Google or GitHub appears under **Connected accounts** after you connect
that provider. There is no connect button on this page. You connect by
signing in with the provider.
To disconnect a connected account:
### Connect provider
1. Sign in to your [Docker account](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select **Account settings**.
> [!IMPORTANT]
>
> If the Google or GitHub email does not match your Docker account email,
> Docker starts a new sign-up and creates a second account instead of
> linking the provider.
Sign in with Google or GitHub using the same email as your Docker account
to add that provider as a sign-in method.
1. Sign out of Docker if you are already signed in.
1. Go to the [Docker sign-in page](https://app.docker.com/login).
1. Select **Continue with Google** or **Continue with GitHub**.
1. Choose a Google or GitHub account that uses the same email address as
your Docker account, then finish the provider sign-in.
Docker links the provider to your account and emails you a confirmation.
The provider then appears in **Connected accounts** under **Account
settings**.
### Disconnect provider
Remove Google or GitHub as a sign-in method from **Connected accounts**.
Your Docker ID stays the same.
1. Sign in to [Docker Home](https://app.docker.com/login).
1. Select your avatar in the top-right corner and select
**Account settings**.
1. Select **Connected accounts**.
1. Select **Disconnect** on your connected account.
1. Select **Disconnect** on that provider.
To fully unlink your Docker account, you must also unlink Docker from Google
or GitHub. See Google or GitHub's documentation for more information:
To remove Docker from the Google or GitHub account, see that provider's
documentation:
- [Manage connections between your Google Account and
third-parties](https://support.google.com/accounts/answer/13533235?hl=en)
- [Reviewing and revoking authorization of GitHub
Apps](https://docs.github.com/en/apps/using-github-apps/reviewing-and-revoking-authorization-of-github-apps)
## Convert your account
For information on converting your account into an organization, see
[Convert an account into an
organization](/manuals/accounts/organization/setup/convert-account.md).
## Deactivate your account
For information on deactivating your account, see
[Deactivate a Docker account](/manuals/accounts/individual/deactivate-user-account.md).
## Next steps
- [Docker individual accounts overview](/manuals/accounts/individual/_index.md)
- [Create a Docker account](/manuals/accounts/individual/create-account.md)
- [Enable two-factor authentication](/manuals/security/authentication/2fa/manage.md)
- [Manage two-factor authentication](/manuals/security/authentication/2fa/manage.md)
- [Create and manage personal access tokens](/manuals/security/access-tokens/personal-access-tokens.md)
- [Convert a Docker account to an organization](/manuals/accounts/organization/setup/convert-account.md)