Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
83 changes: 50 additions & 33 deletions content/manuals/accounts/_index.md
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 >}}
92 changes: 56 additions & 36 deletions content/manuals/accounts/create-account.md
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:
- 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:
- 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

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/).
Expand All @@ -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

Expand All @@ -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)
49 changes: 29 additions & 20 deletions content/manuals/accounts/deactivate-user-account.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,19 @@
---
title: Deactivate a Docker account
linkTitle: Deactivate an account
linkTitle: Deactivate
weight: 30
description: Learn how to deactivate a Docker user account.
keywords: Docker Hub, delete, deactivate, account, account management, delete Docker account, close Docker account, disable Docker account
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
---

Learn how to deactivate an individual Docker account, including prerequisites required
for deactivation.
Learn how to deactivate an individual Docker account, including the
prerequisites required for deactivation.

For information on deactivating an organization,
see [Deactivating an organization](../admin/organization/deactivate-account.md).
For information on deactivating an organization, see
[Deactivate an organization](../admin/organization/deactivate-account.md).

> [!WARNING]
>
Expand All @@ -19,29 +22,35 @@ see [Deactivating an organization](../admin/organization/deactivate-account.md).

## Prerequisites

Before deactivating your Docker account, ensure you meet the following requirements:
Before deactivating your Docker account, ensure you meet 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.
- 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 have an active Docker subscription, [downgrade it to a Docker Personal subscription](../subscription/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.
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/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.
- If you linked a GitHub or Bitbucket account for automated builds, unlink it.
See [Unlink a GitHub user account](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account)
or [Unlink a Bitbucket user account](../docker-hub/repos/manage/builds/link-source.md#unlink-a-bitbucket-user-account).
See
[Unlink a GitHub user account](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account)
or
[Unlink a Bitbucket user account](../docker-hub/repos/manage/builds/link-source.md#unlink-a-bitbucket-user-account).

## Deactivate

Once you have completed all the previous steps, you can deactivate your account.
Once you have completed all the previous steps, you can deactivate your
account.

> [!WARNING]
>
Expand Down
Loading