Skip to content

Freshness for Docker accounts #21438

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
Nov 15, 2024
Merged

Freshness for Docker accounts #21438

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
6b3abef
Freshness for Docker accounts
sarahsanders-docker Nov 14, 2024
11fed81
Update content/manuals/accounts/manage-account.md
sarahsanders-docker Nov 15, 2024
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
41 changes: 23 additions & 18 deletions content/manuals/accounts/create-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@

> [!TIP]
>
> Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what else Docker can offer you.
> Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what subscription plans Docker can offer you.

## Create a Docker ID

Expand All @@ -25,62 +25,67 @@

2. Enter a unique, valid email address.

3. Enter a username.
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.

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

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[Docker.Acronyms] 'ID' has no definition.", "location": {"path": "content/manuals/accounts/create-account.md", "range": {"start": {"line": 28, "column": 43}}}, "severity": "WARNING"}

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

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[Docker.Acronyms] 'ID' has no definition.", "location": {"path": "content/manuals/accounts/create-account.md", "range": {"start": {"line": 28, "column": 75}}}, "severity": "WARNING"}

Your Docker ID must be between 4 and 30 characters long, and can only contain numbers and lowercase letters. 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**.

Docker sends a verification email to the address you provided.
6. Open your email client. Docker sends a verification email to the address you provided.

6. Verify your email address to complete the registration process.
7. Verify your email address to complete the registration process.

> [!NOTE]
>
> You have limited actions available until you verify your email address.
> 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, make sure you 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 allow Docker to access your social account information and be re-routed to the sign-up page.
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.
5. Enter a username to use as your Docker ID.

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

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[Docker.Acronyms] 'ID' has no definition.", "location": {"path": "content/manuals/accounts/create-account.md", "range": {"start": {"line": 60, "column": 43}}}, "severity": "WARNING"}

Your Docker ID must be between 4 and 30 characters long, and can only contain numbers and lowercase letters. 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

6. Select **Sign up**.

## Sign in

Once you register and verify your Docker ID email address, you can sign in to [your Docker account](https://login.docker.com/u/login/). You can sign in with your email address (or username) and password. Or, you can sign in with your social provider. See [Sign in with your social provider](#sign-in-with-your-social-provider).

You can also sign in through the CLI using the `docker login` command. For more information, see [`docker login`](/reference/cli/docker/login.md).
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:

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

View workflow job for this annotation

GitHub Actions / vale 

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

Raw Output:
{"message": "[Docker.Acronyms] 'ID' has no definition.", "location": {"path": "content/manuals/accounts/create-account.md", "range": {"start": {"line": 70, "column": 31}}}, "severity": "WARNING"}
- 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).

> [!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/for-developers/access-tokens.md) to log in instead, which is still encoded in this file (without a Docker credential helper) but doesn't allow admin actions (such as changing the password).
> 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/for-developers/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).

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

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.We] Avoid using first-person plural like 'We'.

Raw Output:
{"message": "[Docker.We] Avoid using first-person plural like 'We'.", "location": {"path": "content/manuals/accounts/create-account.md", "range": {"start": {"line": 80, "column": 3}}}, "severity": "WARNING"}

### Sign in with your social provider

> [!IMPORTANT]
>
> To sign in with your social provider, make sure you verify your email address with your provider before you begin.
> To sign in with your social provider, you must verify your email address with your provider before you begin.

Optionally, you can sign in to an existing 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 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.

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.

Expand All @@ -90,8 +95,8 @@

## Troubleshooting

If you have a paid Docker subscription, you can [contact the Support team](https://hub.docker.com/support/contact/).
If you have a paid Docker subscription, you can [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)
4 changes: 2 additions & 2 deletions content/manuals/accounts/deactivate-user-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@ keywords: Docker Hub, delete, deactivate, account, account management

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/deactivate-account.md).

>[!Warning]
>[!WARNING]
>
> All Docker products and services that use your Docker account will be inaccessible after deactivating your account.

## Prerequisites

Before deactivating your Docker account, ensure that you meet the following requirements:
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:
Expand Down
8 changes: 4 additions & 4 deletions content/manuals/accounts/manage-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,19 @@ description: Learn how to manage settings for your Docker account.
keywords: accounts, docker ID, account settings, account management, docker home
---

You can centrally manage the settings for your Docker account. Here you can also take administrative actions for your account and manage your account security.
You can centrally manage the settings for your Docker account using Docker Home. Here you can also take administrative actions for your account and manage your account security.

> [!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. You need to contact your administrator to update your settings.
> If your account is associated with an organization that enforces single 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

1. Sign in to your [Docker account](https://app.docker.com/login).
2. In Docker Home, select your avatar in the top-right corner to open the drop-down.
3. Select **Account settings**.

From here, you can take any of the following actions.
From the Account settings page, you can take any of the following actions.

### Update account information

Expand Down Expand Up @@ -57,7 +57,7 @@ You can manage the security settings for your account in Docker Home.

For information on two-factor authentication (2FA) for your account, see [Enable two-factor authentication](../security/for-developers/2fa/_index.md) to get started.

For information on personal access tokens (PAT), see [Create and manage access tokens](../security/for-developers/access-tokens.md).
For information on personal access tokens, see [Create and manage access tokens](../security/for-developers/access-tokens.md).

## Account management

Expand Down