Skip to content
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

Jump to bottom

Improve SignIn page regarding ways of signing in #19949

Closed
wants to merge 1 commit into from
Closed

Improve SignIn page regarding ways of signing in #19949

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
27 changes: 24 additions & 3 deletions content/desktop/get-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,6 @@
- /winkit/getting-started/
---

Docker recommends that you authenticate using the **Sign in** option in the top-right corner of the Docker Dashboard.

In large enterprises where admin access is restricted, administrators can [Configure registry.json to enforce sign-in](../security/for-admins/configure-sign-in.md).

> **Tip**
Expand All @@ -45,9 +43,32 @@

- Improve your organization’s security posture for containerized development by taking advantage of [Hardened Desktop](hardened-desktop/index.md).

## Signing in with Docker Desktop

Docker Desktop supports multiple ways of signing in users:

- Using the **Sign in** option in the top-right corner of the Docker Dashboard. This is the <u>recommended</u> option. When clicking on the button, your browser will open and ask for your credentials. Once authentication is successful, the browser will automatically sign Docker Desktop in.

> **Note**
>
> Docker Desktop automatically signs you out after 90 days, or after 30 days of inactivity.
> Docker Desktop automatically signs you out after 90 days, or after 30 days of inactivity.

- Using the Docker CLI: `docker login`. Refer to [Docker CLI "login" documentation](https://docs.docker.com/reference/cli/docker/login/) for additional details. If you sign in against https://hub.docker.com, then Docker Desktop will automatically be signed in.

Check warning on line 56 in content/desktop/get-started.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.RecommendedWords] Consider using 'sign in' instead of 'login'

Raw Output:
{"message": "[Docker.RecommendedWords] Consider using 'sign in' instead of 'login'", "location": {"path": "content/desktop/get-started.md", "range": {"start": {"line": 56, "column": 33}}}, "severity": "INFO"}

> **Note**
>
> Docker Hub provides 2 ways of authenticating with the CLI:
> - via a password
> - via a generated Access Token (available here: https://hub.docker.com/settings/security)

## FAQ

Check warning on line 64 in content/desktop/get-started.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.HeadingSentenceCase] Use sentence case for headings: 'FAQ'.

Raw Output:
{"message": "[Docker.HeadingSentenceCase] Use sentence case for headings: 'FAQ'.", "location": {"path": "content/desktop/get-started.md", "range": {"start": {"line": 64, "column": 4}}}, "severity": "WARNING"}

Q: When signing in with my Docker Hub credentials and Docker CLI (`docker login`), Docker Desktop is not automatically signed in.

A: Check the following file: `$HOME/.docker/config.json`. When using Docker Desktop, the Credential Store (`credsStore`) needs to be `desktop`.

Docker Desktop will automatically use your native credential manager (Apple macOS keychain, Microsoft Windows Credential Manager, D-Bus Secret Service or [pass](https://www.passwordstore.org))


## Signing in with Docker Desktop for Linux

Expand Down