freshness: accounts (#23176)

## Description
Freshness updates for Platform > Accounts

## Related issues or tickets

https://docker.atlassian.net/browse/ENGDOCS-2883?atlOrigin=eyJpIjoiNTUzYmI0NjQ0MGM0NDY1NDllZWUzYWIyZjlhN2JiZTIiLCJwIjoiaiJ9

## Reviews
- [ ] Editorial review

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
This commit is contained in:
Sarah Sanders 2025-07-29 17:21:49 -04:00 committed by GitHub
parent 5408a2e5c4
commit 504ef8a66c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
8 changed files with 180 additions and 150 deletions

View File

@ -1,6 +1,6 @@
---
title: Docker accounts
description: Learn how to create and manage your Docker account.
description: Learn how to create and manage your Docker account
keywords: accounts, docker ID, account management, account settings, docker account, docker home
weight: 30
params:
@ -15,10 +15,6 @@ grid:
description: Learn how to manage the settings for your account.
icon: manage_accounts
link: /accounts/manage-account/
- title: Account FAQ
description: Explore popular FAQ topics about organizations.
icon: help
link: /faq/admin/general-faqs/
- title: Personal access tokens
description: Learn how to create and manage access tokens for your account.
icon: password
@ -31,10 +27,19 @@ grid:
description: Learn how to deactivate a Docker user account.
link: /accounts/deactivate-user-account/
icon: disabled_by_default
- title: Account FAQ
description: Explore frequently asked questions about Docker accounts.
icon: help
link: /accounts/general-faqs/
---
You can create a Docker account to secure a Docker ID, which is a username for your account that lets you access Docker products. You can use your Docker account to sign in to Docker products like Docker Hub, Docker Desktop, or Docker Scout. You can centrally manage your [Docker account settings](https://app.docker.com/settings), as well as account security features, in [Docker Home](https://app.docker.com).
This section covers individual Docker accounts and Docker IDs. It does
not cover organizations, companies, or administrator roles.
In this section, explore how you can create, manage, or update your account.
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
{{< grid >}}

View File

@ -1,5 +1,6 @@
---
title: Create an account
title: Create a Docker account
linkTitle: Create an account
weight: 10
description: Learn how to register for a Docker ID and sign in to your account
keywords: accounts, docker ID, billing, paid plans, support, Hub, Store, Forums, knowledge
@ -9,94 +10,122 @@ aliases:
- /docker-id/
---
You can create a free Docker account with your email address or by signing up with your Google or GitHub account. Once you've created your account with a unique Docker ID, you can access all Docker products, including Docker Hub. With Docker Hub, you can access repositories and explore images that are available from the community and verified publishers.
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.
Your Docker ID becomes your username for hosted Docker services, and [Docker forums](https://forums.docker.com/).
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/) to see what else Docker can offer you.
> Explore [Docker's subscriptions](https://www.docker.com/pricing/) to see what
else Docker can offer you.
## Create a Docker ID
## Create an account
### Sign up with your email address
You can sign up with an email address or use your Google or GitHub account.
### Sign up with your email
1. Go to the [Docker sign-up page](https://app.docker.com/signup/).
2. Enter a unique, valid email address.
3. 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.
1. 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
4. Enter a password that's at least 9 characters long.
5. Select **Sign Up**.
6. Open your email client. Docker sends a verification email to the address you provided.
7. Verify your email address to complete the registration process.
1. Enter a password that's at least 9 characters long.
1. Select **Sign Up**.
1. Open your email client. Docker sends a verification email to the
address you provided.
1. Verify your email address to complete the registration process.
> [!NOTE]
>
> You must verify your email address before you have full access to Docker's features.
> You must verify your email address before you have full access to Docker's
features.
### Sign up with Google or GitHub
> [!IMPORTANT]
>
> To sign up with your social provider, you must verify your email address with your provider before you begin.
> To sign up with your social provider, you must verify your email address with
your provider before you begin.
1. Go to the [Docker sign-up page](https://app.docker.com/signup/).
2. Select your social provider, Google or GitHub.
3. Select the social account you want to link to your Docker account.
4. Select **Authorize Docker** to let Docker to access your social account information. You will be re-routed to the sign-up page.
5. Enter a username to use as your Docker ID.
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.
1. Enter a username to use as your Docker ID.
Your username:
- Must be between 4 and 30 characters long
- Can only contain numbers and lowercase letters
1. Select **Sign up**.
6. Select **Sign up**.
## Sign in to your account
## Sign in
You can sign in with your email, Google or GitHub account, or from
the Docker CLI.
Once you register your Docker ID and verify your email address, you can sign in to [your Docker account](https://login.docker.com/u/login/). You can either:
- Sign in with your email address (or username) and password.
- Sign in with your social provider. For more information, see [Sign in with your social provider](#sign-in-with-your-social-provider).
- Sign in through the CLI using the `docker login` command. For more information, see [`docker login`](/reference/cli/docker/login.md).
### Sign in with email or Docker ID
> [!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](https://github.com/docker/docker-credential-helpers) for secure storage of passwords. For extra security, you can also use a [personal access token](../security/access-tokens.md) to sign in instead, which is still encoded in this file (without a Docker credential helper) but doesn't permit administrator actions (such as changing the password).
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**.
### Sign in with your social provider
To reset your password, see [Reset your password](#reset-your-password).
### Sign in with Google or GitHub
> [!IMPORTANT]
>
> To sign in with your social provider, you must verify your email address with your provider before you begin.
> Your Google or GitHub account must have a verified email address.
You can also sign in to your Docker account with your Google or GitHub account. If a Docker account exists with the same email address as the primary email for your social provider, your Docker account will automatically be linked to the social profile. This lets you sign in with your social provider.
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.
If you try to sign in with your social provider and don't have a Docker account yet, a new account will be created for you. Follow the on-screen instructions to create a Docker ID using your social provider.
If no Docker ID exists, Docker creates a new account for you.
## Reset your password at sign in
Docker doesn't currently support linking multiple sign-in methods
to the same Docker ID.
To reset your password, enter your email address on the [Sign in](https://login.docker.com/u/login) page and continue to sign in. When prompted for your password, select **Forgot password?**.
### Sign in using the CLI
Use the `docker login` command to authenticate from the command line. For
details, see [`docker login`](/reference/cli/docker/login/).
> [!WARNING]
>
> The `docker login` command stores credentials in your home directory under
> `.docker/config.json`. The password is base64-encoded.
>
> 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.
## Reset your password
To reset your password:
1. Go to the [Docker sign in page](https://login.docker.com/).
1. Enter your email address.
1. When prompted for your password, select **Forgot password?**.
## Troubleshooting
If you have a paid Docker subscription, you can [contact the Support team](https://hub.docker.com/support/contact/) for assistance.
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:
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](http://dockr.ly/comm-slack)

View File

@ -1,34 +1,40 @@
---
title: Deactivate an account
title: Deactivate a Docker account
linkTitle: Deactivate an account
weight: 30
description: Learn how to deactivate a Docker user account.
keywords: Docker Hub, delete, deactivate, account, account management
keywords: Docker Hub, delete, deactivate, account, account management, delete Docker account, close Docker account, disable Docker account
---
You can deactivate an account at any time. This section describes the prerequisites and steps to deactivate a user account. For information on deactivating an organization, see [Deactivating an organization](../admin/organization/deactivate-account.md).
Learn how to deactivate an individual Docker account, including prerequisites required
for deactivation.
>[!WARNING]
For information on deactivating an organization,
see [Deactivating an organization](../admin/organization/deactivate-account.md).
> [!WARNING]
>
> All Docker products and services that use your Docker account will be inaccessible after deactivating your account.
> All Docker products and services that use your Docker account are
inaccessible after deactivating your account.
## Prerequisites
Before deactivating your Docker account, ensure you meet the following requirements:
- For owners, you must leave your organization or company before deactivating your Docker account.
To do this:
- 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 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 have an active Docker subscription, [downgrade it to a Docker Personal subscription](../subscription/change.md).
- Download any images and tags you want to keep. Use `docker pull -a <image>:<tag>`.
- Unlink your [GitHub and Bitbucket accounts](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
- Unlink your [GitHub and account](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
## Deactivate
@ -36,11 +42,11 @@ Once you have completed all the previous steps, you can deactivate your account.
> [!WARNING]
>
> This cannot be undone. Be sure you've gathered all the data you need from your account before deactivating it.
> Deactivating your account is permanent and can't be undone. Make sure
to back up any important data.
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**.
1. To confirm, select **Deactivate account**.
1. Select **Deactivate account**, then select again to confirm.

View File

@ -2,13 +2,14 @@
title: FAQs on Docker accounts
linkTitle: Accounts
weight: 10
description: Frequently asked Docker account and administration questions
description: Frequently asked questions about Docker accounts
keywords: onboarding, docker, teams, orgs, user accounts, organization accounts
tags: [FAQ]
aliases:
- /docker-hub/general-faqs/
- /docker-hub/onboarding-faqs/
- /faq/admin/general-faqs/
- /admin/faqs/general-faqs/
---
### What is a Docker ID?
@ -46,30 +47,3 @@ Docker ID for you.
The organization name, sometimes referred to as the organization namespace or
the organization ID, is the unique identifier of a Docker organization. The
organization name can't be the same as an existing Docker ID.
### Who is an organization owner?
An organization owner is a member who has administrator permissions. They
have full access to private repositories, all teams, billing information, and
organization settings.
For more information on the organization owner role, see [Roles and permissions](/manuals/enterprise/security/roles-and-permissions.md).
### Can I configure multiple SSO identity providers (IdPs) to authenticate users to a single org?
Yes. Docker SSO supports multiple IdP configurations. For more
information, see [Configure SSO](/manuals/enterprise/security/single-sign-on/configure.md) and [SSO FAQs](../../security/faqs/single-sign-on/faqs.md).
### What is a service account?
Service accounts were deprecated on December 10, 2024. Existing Service Account
agreements will be honored until their current term expires, but new purchases
or renewals of service accounts are no longer available and customers must renew
under a new subscription.
For similar functionality,
transition to [Organization access tokens](/manuals/enterprise/security/access-tokens.md).
### Can I delete or deactivate a Docker account for another user?
Only someone with access to the Docker account can deactivate the account. For more details, see [Deactivating an account](../../admin/organization/deactivate-account.md).

View File

@ -1,13 +1,13 @@
---
title: Manage an account
title: Manage a Docker account
linkTitle: Manage an account
weight: 20
description: Learn how to manage settings for your Docker account.
description: Learn how to manage your Docker account.
keywords: accounts, docker ID, account settings, account management, docker home
---
You can centrally manage your Docker account settings using Docker Home. Here
you can also take administrative actions for your account and manage your
account security.
You can centrally manage your Docker account using Docker Home, including
adminstrative and security settings.
> [!TIP]
>
@ -15,43 +15,41 @@ account security.
> sign-on (SSO), you may not have permissions to update your account settings.
> You must contact your administrator to update your settings.
## Update general settings
## Update account information
1. Sign in to your [Docker account](https://app.docker.com/login).
2. Select your avatar in the top-right corner and select **Account settings**.
From the Account settings page, you can take any of the following actions.
### Update account information
Account information is visible on your account profile in Docker Hub. You can
Account information is visible on your **Account settings** page. You can
update the following account information:
- Full name
- Company
- Location
- Website
- Gravatar email: To add an avatar to your Docker account, create a
[Gravatar account](https://gravatar.com/) and create your avatar. Next, add your
Gravatar email to your Docker account settings. It may take some time for your
avatar to update in Docker.
- Gravatar email
Make your changes here, then select **Save** to save your settings.
To add or update your avatar using Gravatar:
### Update email address
1. Create a [Gravatar account](https://gravatar.com/).
1. Create your avatar.
1. Add your Gravatar email to your Docker account settings.
To update your email address, select **Email**:
It may take some time for your avatar to update in Docker.
1. Enter your new email address.
2. Enter your password to confirm the change.
3. Select **Send verification email** to send a verification email to your new
email address.
## Update email address
To update your email address:
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 **Email**.
1. Enter your new email address and your password to confirm the change.
1. Select **Send verification email**. Docker sends a verification
link to your new email.
Your new email address will appear as unverified until you complete the
verification process. You can:
- Resend the verification email if needed.
- Removed the unverified email address at any time before verification.
- Remove the unverified email address at any time before verification.
To verify your email, open your email client and follow the instructions
in the Docker verification email.
@ -62,42 +60,59 @@ in the Docker verification email.
is used for account notifications and security-related communications. You
can't add multiple verified email addresses to your account.
### Change your password
## Change your password
You can change your password by initiating a password reset via email.
You can change your password by initiating a password reset via email. To change your password:
To change your password, select **Password** and then **Reset password**.
Follow the instructions in the password reset 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. Select **Password**, then **Reset password**.
1. Docker will send you a password reset email with instructions to reset
your password.
## Manage security settings
## Manage two-factor authentication
To update your two-factor authentication (2FA) settings, select **2FA**.
For information on two-factor authentication (2FA) for your account, see
[Enable two-factor authentication](../security/2fa/_index.md)
to get started.
To update your two-factor authentication (2FA) settings:
To manage personal access tokens, select **Personal access tokens**.
For information on personal access tokens, see
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](../security/2fa/_index.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](../security/access-tokens.md).
## Manage connected accounts
You can unlink Google or GitHub accounts that are linked to your Docker account
using the Account settings page:
You can unlink connected Google or GitHub accounts:
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 **Connected accounts**.
2. Select **Disconnect** on your connected account.
3. To fully unlink your Docker account, you must also unlink Docker from Google
1. Select **Disconnect** on your connected account.
To fully unlink your Docker account, you must also unlink Docker from Google
or GitHub. See Google or GitHub's documentation for more information:
- [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)
## Account management
- [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)
To convert your account into an organization, select **Convert**.
For more information on converting your account, see
## Convert your account
For information on converting your account into an organization, see
[Convert an account into an organization](../admin/organization/convert-account.md).
To deactivate your account, select **Deactivate**.
## Deactivate your account
For information on deactivating your account, see
[Deactivating a user account](./deactivate-user-account.md).

View File

@ -41,7 +41,7 @@ A pull is defined as the following:
## Pull attribution
Pulls from authenticated users can be attributed to either a personal or an
[organization namespace](/manuals/admin/faqs/general-faqs.md#whats-an-organization-name-or-namespace).
[organization namespace](/manuals/accounts/general-faqs.md#whats-an-organization-name-or-namespace).
Attribution is based on the following:

View File

@ -73,7 +73,7 @@ When you downgrade your subscription, access to paid features is available until
> If you downgrade your personal account from a Pro subscription to a Personal subscription, note that [Personal subscriptions](details.md#docker-personal) don't include collaborators for private repositories. Only one private repository is included with a Personal subscription. When you downgrade, all collaborators will be removed and additional private repositories are locked.
> Before you downgrade, consider the following:
> - Team size: You may need to reduce the number of team members and convert any private repositories to public repositories or delete them. For information on features available in each tier, see [Docker Pricing](https://www.docker.com/pricing).
> - SSO and SCIM: If you want to downgrade a Docker Business subscription and your organization uses single sign-on (SSO) for user authentication, you need to remove your SSO connection and verified domains before downgrading. After removing the SSO connection, any organization members that were auto-provisioned (for example, with SCIM) need to set up a password to sign in without SSO. To do this, users can [reset their password at sign in](/accounts/create-account/#reset-your-password-at-sign-in).
> - SSO and SCIM: If you want to downgrade a Docker Business subscription and your organization uses single sign-on (SSO) for user authentication, you need to remove your SSO connection and verified domains before downgrading. After removing the SSO connection, any organization members that were auto-provisioned (for example, with SCIM) need to set up a password to sign in without SSO. To do this, users can [reset their password at sign in](/accounts/create-account/#reset-your-password).
{{< tabs >}}
{{< tab name="Docker subscription" >}}

View File

@ -69,6 +69,7 @@
"Heredocs",
"Hyper-V-backend-x86_64",
"Inline",
"Instant-verification",
"JSON",
"Java",
"JavaScript",
@ -88,6 +89,7 @@
"Mac-with-Apple-silicon",
"Mac-with-Intel-chip",
"MacOS",
"Manual-verification",
"Manually-create-assets",
"NetworkManager",
"Networking-mode",
@ -335,12 +337,10 @@
"hover:bg-blue-500",
"hover:bg-gray-100",
"hover:bg-gray-200",
"hover:bg-gray-300",
"hover:bg-gray-50",
"hover:bg-white/20",
"hover:border-white/20",
"hover:dark:bg-blue-500",
"hover:dark:bg-gray-300",
"hover:dark:bg-gray-800",
"hover:dark:text-blue-400",
"hover:dark:text-blue-700",
@ -383,7 +383,6 @@
"link",
"lntable",
"lntd",
"m-2",
"macOS",
"max-h-full",
"max-w-4xl",
@ -432,6 +431,7 @@
"mt-4",
"mt-8",
"mt-[2px]",
"mx-1",
"mx-auto",
"my-0",
"my-4",
@ -549,6 +549,7 @@
"text-gray-300",
"text-gray-400",
"text-gray-500",
"text-gray-700",
"text-gray-800",
"text-left",
"text-lg",