Skip to content

Commit 504ef8a

Browse files
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 <[email protected]>
1 parent 5408a2e commit 504ef8a

File tree

8 files changed

+180
-150
lines changed

8 files changed

+180
-150
lines changed

content/manuals/accounts/_index.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Docker accounts
3-
description: Learn how to create and manage your Docker account.
3+
description: Learn how to create and manage your Docker account
44
keywords: accounts, docker ID, account management, account settings, docker account, docker home
55
weight: 30
66
params:
@@ -15,10 +15,6 @@ grid:
1515
description: Learn how to manage the settings for your account.
1616
icon: manage_accounts
1717
link: /accounts/manage-account/
18-
- title: Account FAQ
19-
description: Explore popular FAQ topics about organizations.
20-
icon: help
21-
link: /faq/admin/general-faqs/
2218
- title: Personal access tokens
2319
description: Learn how to create and manage access tokens for your account.
2420
icon: password
@@ -31,10 +27,19 @@ grid:
3127
description: Learn how to deactivate a Docker user account.
3228
link: /accounts/deactivate-user-account/
3329
icon: disabled_by_default
30+
- title: Account FAQ
31+
description: Explore frequently asked questions about Docker accounts.
32+
icon: help
33+
link: /accounts/general-faqs/
3434
---
3535

36-
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).
36+
This section covers individual Docker accounts and Docker IDs. It does
37+
not cover organizations, companies, or administrator roles.
3738

38-
In this section, explore how you can create, manage, or update your account.
39+
A Docker account is required to:
40+
- Create a Docker ID
41+
- Access Docker products and services like Docker Hub and Docker Desktop
42+
- Receive organization invitations
43+
- Manage your personal settings and security features
3944

4045
{{< grid >}}
Lines changed: 76 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
2-
title: Create an account
2+
title: Create a Docker account
3+
linkTitle: Create an account
34
weight: 10
45
description: Learn how to register for a Docker ID and sign in to your account
56
keywords: accounts, docker ID, billing, paid plans, support, Hub, Store, Forums, knowledge
@@ -9,94 +10,122 @@ aliases:
910
- /docker-id/
1011
---
1112

12-
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.
13+
You can create a free Docker account with your email address or by signing up
14+
with your Google or GitHub account. After creating a unique Docker ID, you can
15+
access all Docker products, including Docker Hub, Docker Desktop, and Docker Scout.
1316

14-
Your Docker ID becomes your username for hosted Docker services, and [Docker forums](https://forums.docker.com/).
17+
Your Docker ID becomes your username for hosted Docker services, and
18+
[Docker forums](https://forums.docker.com/).
1519

1620
> [!TIP]
1721
>
18-
> Explore [Docker's subscriptions](https://www.docker.com/pricing/) to see what else Docker can offer you.
22+
> Explore [Docker's subscriptions](https://www.docker.com/pricing/) to see what
23+
else Docker can offer you.
1924

20-
## Create a Docker ID
25+
## Create an account
2126

22-
### Sign up with your email address
27+
You can sign up with an email address or use your Google or GitHub account.
2328

24-
1. Go to the [Docker sign-up page](https://app.docker.com/signup/).
25-
26-
2. Enter a unique, valid email address.
29+
### Sign up with your email
2730

28-
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.
31+
1. Go to the [Docker sign-up page](https://app.docker.com/signup/).
32+
1. Enter a unique, valid email address.
33+
1. Enter a username to use as your Docker ID. Once you create your Docker ID
34+
you can't reuse it in the future if you deactivate this account.
2935

3036
Your username:
3137
- Must be between 4 and 30 characters long
3238
- Can only contain numbers and lowercase letters
3339

34-
4. Enter a password that's at least 9 characters long.
35-
36-
5. Select **Sign Up**.
37-
38-
6. Open your email client. Docker sends a verification email to the address you provided.
39-
40-
7. Verify your email address to complete the registration process.
40+
1. Enter a password that's at least 9 characters long.
41+
1. Select **Sign Up**.
42+
1. Open your email client. Docker sends a verification email to the
43+
address you provided.
44+
1. Verify your email address to complete the registration process.
4145

4246
> [!NOTE]
4347
>
44-
> You must verify your email address before you have full access to Docker's features.
48+
> You must verify your email address before you have full access to Docker's
49+
features.
4550

4651
### Sign up with Google or GitHub
4752

4853
> [!IMPORTANT]
4954
>
50-
> To sign up with your social provider, you must verify your email address with your provider before you begin.
55+
> To sign up with your social provider, you must verify your email address with
56+
your provider before you begin.
5157

5258
1. Go to the [Docker sign-up page](https://app.docker.com/signup/).
53-
54-
2. Select your social provider, Google or GitHub.
55-
56-
3. Select the social account you want to link to your Docker account.
57-
58-
4. Select **Authorize Docker** to let Docker to access your social account information. You will be re-routed to the sign-up page.
59-
60-
5. Enter a username to use as your Docker ID.
59+
1. Select your social provider, Google or GitHub.
60+
1. Select the social account you want to link to your Docker account.
61+
1. Select **Authorize Docker** to let Docker access your social account
62+
information. You will be re-routed to the sign-up page.
63+
1. Enter a username to use as your Docker ID.
6164

6265
Your username:
6366
- Must be between 4 and 30 characters long
6467
- Can only contain numbers and lowercase letters
68+
1. Select **Sign up**.
6569

66-
6. Select **Sign up**.
70+
## Sign in to your account
6771

68-
## Sign in
72+
You can sign in with your email, Google or GitHub account, or from
73+
the Docker CLI.
6974

70-
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:
71-
- Sign in with your email address (or username) and password.
72-
- Sign in with your social provider. For more information, see [Sign in with your social provider](#sign-in-with-your-social-provider).
73-
- Sign in through the CLI using the `docker login` command. For more information, see [`docker login`](/reference/cli/docker/login.md).
75+
### Sign in with email or Docker ID
7476

75-
> [!WARNING]
76-
>
77-
> When you use the `docker login` command, your credentials are
78-
stored in your home directory in `.docker/config.json`. The password is base64-encoded in this file.
79-
>
80-
> 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).
77+
1. Go to the [Docker sign in page](https://login.docker.com).
78+
1. Enter your email address or Docker ID and select **Continue**.
79+
1. Enter your password and select **Continue**.
80+
81+
To reset your password, see [Reset your password](#reset-your-password).
8182

82-
### Sign in with your social provider
83+
### Sign in with Google or GitHub
8384

8485
> [!IMPORTANT]
8586
>
86-
> To sign in with your social provider, you must verify your email address with your provider before you begin.
87+
> Your Google or GitHub account must have a verified email address.
88+
89+
You can sign in using your Google or GitHub credentials. If your social
90+
account uses the same email address as an existing Docker ID, the
91+
accounts are automatically linked.
92+
93+
If no Docker ID exists, Docker creates a new account for you.
94+
95+
Docker doesn't currently support linking multiple sign-in methods
96+
to the same Docker ID.
8797

88-
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.
98+
### Sign in using the CLI
99+
100+
Use the `docker login` command to authenticate from the command line. For
101+
details, see [`docker login`](/reference/cli/docker/login/).
102+
103+
> [!WARNING]
104+
>
105+
> The `docker login` command stores credentials in your home directory under
106+
> `.docker/config.json`. The password is base64-encoded.
107+
>
108+
> To improve security, use
109+
> [Docker credential helpers](https://github.com/docker/docker-credential-helpers).
110+
> For even stronger protection, use a [personal access token](../security/access-tokens.md)
111+
> instead of a password. This is especially useful in CI/CD environments
112+
> or when credential helpers aren't available.
89113
90-
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.
114+
## Reset your password
91115

92-
## Reset your password at sign in
116+
To reset your password:
93117

94-
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?**.
118+
1. Go to the [Docker sign in page](https://login.docker.com/).
119+
1. Enter your email address.
120+
1. When prompted for your password, select **Forgot password?**.
95121

96122
## Troubleshooting
97123

98-
If you have a paid Docker subscription, you can [contact the Support team](https://hub.docker.com/support/contact/) for assistance.
124+
If you have a paid Docker subscription,
125+
[contact the Support team](https://hub.docker.com/support/contact/) for assistance.
99126

100-
All Docker users can seek troubleshooting information and support through the following resources, where Docker or the community respond on a best effort basis:
127+
All Docker users can seek troubleshooting information and support through the
128+
following resources, where Docker or the community respond on a best effort
129+
basis:
101130
- [Docker Community Forums](https://forums.docker.com/)
102131
- [Docker Community Slack](http://dockr.ly/comm-slack)
Lines changed: 22 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,52 @@
11
---
2-
title: Deactivate an account
2+
title: Deactivate a Docker account
3+
linkTitle: Deactivate an account
34
weight: 30
45
description: Learn how to deactivate a Docker user account.
5-
keywords: Docker Hub, delete, deactivate, account, account management
6+
keywords: Docker Hub, delete, deactivate, account, account management, delete Docker account, close Docker account, disable Docker account
67
---
78

8-
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).
9+
Learn how to deactivate an individual Docker account, including prerequisites required
10+
for deactivation.
911

10-
>[!WARNING]
12+
For information on deactivating an organization,
13+
see [Deactivating an organization](../admin/organization/deactivate-account.md).
14+
15+
> [!WARNING]
1116
>
12-
> All Docker products and services that use your Docker account will be inaccessible after deactivating your account.
17+
> All Docker products and services that use your Docker account are
18+
inaccessible after deactivating your account.
1319

1420
## Prerequisites
1521

1622
Before deactivating your Docker account, ensure you meet the following requirements:
1723

18-
- For owners, you must leave your organization or company before deactivating your Docker account.
19-
To do this:
24+
- If you are an organization or company owner, you must leave your organization
25+
or company before deactivating your Docker account:
2026
1. Sign in to [Docker Home](https://app.docker.com/admin) and choose
2127
your organization.
2228
1. Select **Members** and find your username.
2329
1. Select the **Actions** menu and then select **Leave organization**.
24-
25-
- 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.
26-
30+
- If you are the sole owner of an organization, you must assign the owner role
31+
to another member of the organization and then remove yourself from the
32+
organization, or deactivate the organization. Similarly, if you are the sole
33+
owner of a company, either add someone else as a company owner and then remove
34+
yourself, or deactivate the company.
2735
- If you have an active Docker subscription, [downgrade it to a Docker Personal subscription](../subscription/change.md).
28-
2936
- Download any images and tags you want to keep. Use `docker pull -a <image>:<tag>`.
30-
31-
- Unlink your [GitHub and Bitbucket accounts](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
37+
- Unlink your [GitHub and account](../docker-hub/repos/manage/builds/link-source.md#unlink-a-github-user-account).
3238

3339
## Deactivate
3440

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

3743
> [!WARNING]
3844
>
39-
> This cannot be undone. Be sure you've gathered all the data you need from your account before deactivating it.
45+
> Deactivating your account is permanent and can't be undone. Make sure
46+
to back up any important data.
4047

4148
1. Sign in to [Docker Home](https://app.docker.com/login).
4249
1. Select your avatar to open the drop-down menu.
4350
1. Select **Account settings**.
4451
1. Select **Deactivate**.
45-
1. Select **Deactivate account**.
46-
1. To confirm, select **Deactivate account**.
52+
1. Select **Deactivate account**, then select again to confirm.

content/manuals/admin/faqs/general-faqs.md renamed to content/manuals/accounts/general-faqs.md

Lines changed: 2 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,14 @@
22
title: FAQs on Docker accounts
33
linkTitle: Accounts
44
weight: 10
5-
description: Frequently asked Docker account and administration questions
5+
description: Frequently asked questions about Docker accounts
66
keywords: onboarding, docker, teams, orgs, user accounts, organization accounts
77
tags: [FAQ]
88
aliases:
99
- /docker-hub/general-faqs/
1010
- /docker-hub/onboarding-faqs/
1111
- /faq/admin/general-faqs/
12+
- /admin/faqs/general-faqs/
1213
---
1314

1415
### What is a Docker ID?
@@ -46,30 +47,3 @@ Docker ID for you.
4647
The organization name, sometimes referred to as the organization namespace or
4748
the organization ID, is the unique identifier of a Docker organization. The
4849
organization name can't be the same as an existing Docker ID.
49-
50-
### Who is an organization owner?
51-
52-
An organization owner is a member who has administrator permissions. They
53-
have full access to private repositories, all teams, billing information, and
54-
organization settings.
55-
56-
For more information on the organization owner role, see [Roles and permissions](/manuals/enterprise/security/roles-and-permissions.md).
57-
58-
### Can I configure multiple SSO identity providers (IdPs) to authenticate users to a single org?
59-
60-
Yes. Docker SSO supports multiple IdP configurations. For more
61-
information, see [Configure SSO](/manuals/enterprise/security/single-sign-on/configure.md) and [SSO FAQs](../../security/faqs/single-sign-on/faqs.md).
62-
63-
### What is a service account?
64-
65-
Service accounts were deprecated on December 10, 2024. Existing Service Account
66-
agreements will be honored until their current term expires, but new purchases
67-
or renewals of service accounts are no longer available and customers must renew
68-
under a new subscription.
69-
70-
For similar functionality,
71-
transition to [Organization access tokens](/manuals/enterprise/security/access-tokens.md).
72-
73-
### Can I delete or deactivate a Docker account for another user?
74-
75-
Only someone with access to the Docker account can deactivate the account. For more details, see [Deactivating an account](../../admin/organization/deactivate-account.md).

0 commit comments

Comments
 (0)