Skip to content

Commit 69b3d7a

Browse files
authored
Freshness: desktop troubleshoot (#24705)
<!--Delete sections as needed --> ## Description <!-- Tell us what you did and why --> ## Related issues or tickets Closes #24703 Closes #24702 Closes #24696 Closes #24695 ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review
1 parent cf3348d commit 69b3d7a

4 files changed

Lines changed: 7 additions & 41 deletions

File tree

content/manuals/desktop/troubleshoot-and-support/faqs/general.md

Lines changed: 2 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -18,26 +18,12 @@ weight: 10
1818
Yes, you can use Docker Desktop offline. However, you
1919
cannot access features that require an active internet
2020
connection. Additionally, any functionality that requires you to sign in won't work while using Docker Desktop offline or in air-gapped environments.
21-
This includes:
22-
23-
- The resources in the [Learning Center](/manuals/desktop/use-desktop/_index.md)
24-
- Pulling or pushing an image to Docker Hub
25-
- [Image Access Management](/manuals/security/access-tokens.md)
26-
- [Static vulnerability scanning](/manuals/docker-hub/repos/manage/vulnerability-scanning.md)
27-
- Viewing remote images in the Docker Dashboard
28-
- Docker Build when using [BuildKit](/manuals/build/buildkit/_index.md#getting-started).
29-
You can work around this by disabling BuildKit. Run `DOCKER_BUILDKIT=0 docker build .` to disable BuildKit.
30-
- [Kubernetes](/manuals/desktop/use-desktop/kubernetes.md) (Images are download when you enable Kubernetes for the first time)
31-
- Checking for updates
32-
- [In-app diagnostics](/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md#diagnose-from-the-app) (including the [Self-diagnose tool](/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md#diagnose-from-the-app))
33-
- Sending usage statistics
34-
- When `networkMode` is set to `mirrored`
3521

3622
### How do I connect to the remote Docker Engine API?
3723

3824
To connect to the remote Engine API, you might need to provide the location of the Engine API for Docker clients and development tools.
3925

40-
Mac and Windows WSL 2 users can connect to the Docker Engine through a Unix socket: `unix:///var/run/docker.sock`.
26+
Mac and Windows WSL 2 users can connect to the Docker Engine through a Unix socket: `unix:///var/run/docker.sock`. Docker Desktop for Linux uses a [per-user socket](linuxfaqs.md#how-do-i-use-docker-sdks-with-docker-desktop-for-linux) located at `~/.docker/desktop/docker.sock` instead of the system-wide `/var/run/docker.sock`.
4127

4228
If you are working with applications like [Apache Maven](https://maven.apache.org/)
4329
that expect settings for `DOCKER_HOST` and `DOCKER_CERT_PATH` environment
@@ -54,8 +40,6 @@ Docker Desktop Windows users can connect to the Docker Engine through a **named
5440

5541
For details, see [Docker Engine API](/reference/api/engine/_index.md).
5642

57-
See the [Linux FAQs](linuxfaqs.md) for Linux specific setup.
58-
5943
### How do I connect from a container to a service on the host?
6044

6145
The host has a changing IP address, or none if you have no network access.
@@ -126,7 +110,7 @@ You can then sign in to your machine with the user ID specified, and launch Dock
126110

127111
> [!NOTE]
128112
>
129-
> Before launching Docker Desktop, if a `settings-store.json` file (or `settings.json` for Docker Desktop versions 4.34 and earlier) already exists in the `~/Library/Group Containers/group.com.docker/` directory, you will see a **Finish setting up Docker Desktop** window that prompts for administrator privileges when you select **Finish**. To avoid this, ensure you delete the `settings-store.json` file (or `settings.json` for Docker Desktop versions 4.34 and earlier) left behind from any previous installations before launching the application.
113+
> Before launching Docker Desktop, if a `settings-store.json` file already exists in the `~/Library/Group Containers/group.com.docker/` directory, you will see a **Finish setting up Docker Desktop** window that prompts for administrator privileges when you select **Finish**. To avoid this, ensure you delete the `settings-store.json` file left behind from any previous installations before launching the application.
130114
131115
{{< /tab >}}
132116
{{< tab name="Windows" >}}

content/manuals/desktop/troubleshoot-and-support/faqs/releases.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ tags: [FAQ]
88

99
### How frequent will new releases be?
1010

11-
New releases are available roughly every month, unless there are critical fixes that need to be released sooner.
11+
New releases are available every week, unless there are critical fixes that need to be released sooner.
1212

1313
The **Automatically check for updates** setting in the **Software updates** tab is turned on by default. This means you receive notifications in the Docker menu and a notification badge on the Docker Desktop Dashboard when a new version is available.
1414

content/manuals/desktop/troubleshoot-and-support/faqs/windowsfaqs.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,8 @@ in the Docker Engine topics.
4848
### How do I add client certificates?
4949

5050
You can add your client certificates
51-
in `~/.docker/certs.d/<MyRegistry><Port>/client.cert` and
52-
`~/.docker/certs.d/<MyRegistry><Port>/client.key`. You do not need to push your certificates with `git` commands.
51+
in `~/.docker/certs.d/<MyRegistry>:<Port>/client.cert` and
52+
`~/.docker/certs.d/<MyRegistry>:<Port>/client.key`. You do not need to push your certificates with `git` commands.
5353

5454
When the Docker Desktop application starts, it copies the
5555
`~/.docker/certs.d` folder on your Windows system to the `/etc/docker/certs.d`

content/manuals/desktop/troubleshoot-and-support/troubleshoot/topics.md

Lines changed: 2 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Docker Desktop uses hardware-accelerated graphics by default, which may cause pr
5555

5656
Disable hardware acceleration:
5757

58-
1. Edit Docker Desktop's `settings-store.json` file (or `settings.json` for Docker Desktop versions 4.34 and earlier). You can find this file at:
58+
1. Edit Docker Desktop's `settings-store.json` file. You can find this file at:
5959

6060
- Mac: `~/Library/Group Containers/group.com.docker/settings-store.json`
6161
- Windows: `C:\Users\[USERNAME]\AppData\Roaming\Docker\settings-store.json`
@@ -216,32 +216,14 @@ See also, [Hypervisor Framework
216216
Reference](https://developer.apple.com/library/mac/documentation/DriversKernelHardware/Reference/Hypervisor/)
217217
in the Apple documentation, and Docker Desktop [Mac system requirements](/manuals/desktop/setup/install/mac-install.md#system-requirements).
218218

219-
### VPNKit keeps breaking
220-
221-
#### Cause
222-
223-
In Docker Desktop version 4.19, gVisor replaced VPNKit to enhance the performance of VM networking when using the Virtualization framework on macOS 13 and later.
224-
225-
#### Solution
226-
227-
To continue using VPNKit:
228-
229-
1. Open your `settings-store.json` file located at `~/Library/Group Containers/group.com.docker/settings-store.json`
230-
2. Add:
231-
232-
```JSON
233-
$ "networkType":"vpnkit"
234-
```
235-
3. Save the file and restart Docker Desktop.
236-
237219
## Topics for Windows
238220

239221
### Docker Desktop fails to start when anti-virus software is installed
240222

241223
#### Cause
242224

243225
Some anti-virus software may be incompatible with Hyper-V and Microsoft
244-
Windows 10 builds. The conflict
226+
Windows builds. The conflict
245227
typically occurs after a Windows update and
246228
manifests as an error response from the Docker daemon and a Docker Desktop start failure.
247229

0 commit comments

Comments
 (0)