Skip to content

freshness: accounts #23176

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.

Sign up for GitHub

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

Merged
merged 2 commits into from
Jul 29, 2025
Merged

freshness: accounts #23176

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6ca37b3
freshness: accounts
sarahsanders-docker Jul 28, 2025
3267740
Update content/manuals/accounts/create-account.md
sarahsanders-docker Jul 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 12 additions & 7 deletions content/manuals/accounts/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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:
Expand All @@ -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
Expand All @@ -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 >}}
123 changes: 76 additions & 47 deletions content/manuals/accounts/create-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -9,94 +10,122 @@
- /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.

1. Go to the [Docker sign-up page](https://app.docker.com/signup/).

2. Enter a unique, valid email address.
### Sign up with your email

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. Go to the [Docker sign-up page](https://app.docker.com/signup/).
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**.

To reset your password, see [Reset your password](#reset-your-password).

### Sign in with your social provider
### 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 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 no Docker ID exists, Docker creates a new account for you.

Docker doesn't currently support linking multiple sign-in methods
to the same Docker ID.

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.
### 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

Check warning on line 111 in content/manuals/accounts/create-account.md

View workflow job for this annotation

GitHub Actions / validate (vale) 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'CD' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'CD' has no definition.", "location": {"path": "content/manuals/accounts/create-account.md", "range": {"start": {"line": 111, "column": 58}}}, "severity": "WARNING"}
> or when credential helpers aren't available.

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.
## Reset your password

## Reset your password at sign in
To reset your password:

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?**.
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)
38 changes: 22 additions & 16 deletions content/manuals/accounts/deactivate-user-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,46 +1,52 @@
---
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

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.
30 changes: 2 additions & 28 deletions content/manuals/admin/faqs/general-faqs.md → content/manuals/accounts/general-faqs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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?
Expand Down Expand Up @@ -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).
Loading