You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/manuals/desktop/troubleshoot-and-support/faqs/macfaqs.md
-18Lines changed: 0 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,18 +11,6 @@ aliases:
11
11
weight: 20
12
12
---
13
13
14
-
### Why do I keep getting a notification telling me an application has changed my Desktop configurations?
15
-
16
-
You receive this notification because the Configuration integrity check feature has detected that a third-party application has altered your Docker Desktop configuration. This usually happens due to incorrect or missing symlinks. The notification ensures you are aware of these changes so you can review and repair any potential issues to maintain system reliability.
17
-
18
-
Opening the notification presents a pop-up window which provides detailed information about the detected integrity issues.
19
-
20
-
If you choose to ignore the notification, it will be shown again only at the next Docker Desktop startup. If you choose to repair your configuration, you won't be prompted again.
21
-
22
-
If you want to switch off Configuration integrity check notifications, navigate to Docker Desktop's settings and in the **General** tab, clear the **Automatically check configuration** setting.
23
-
24
-
If you have feedback on how to further improve the Configuration integrity check feature, [fill out the feedback form](https://docs.google.com/forms/d/e/1FAIpQLSeD_Odqc__4ihRXDtH_ba52QJuaKZ00qGnNa_tM72MmH32CZw/viewform).
25
-
26
14
### What is HyperKit?
27
15
28
16
HyperKit is a hypervisor built on top of the Hypervisor.framework in macOS. It runs entirely in userspace and has no other dependencies.
@@ -34,12 +22,6 @@ VirtualBox or VMWare Fusion.
34
22
35
23
HyperKit is thinner than VirtualBox and VMWare fusion, and the version included is customized for Docker workloads on Mac.
36
24
37
-
### Why is com.docker.vmnetd still running after I quit the app?
38
-
39
-
The privileged helper process `com.docker.vmnetd` is started by `launchd` and
40
-
runs in the background. The process does not consume any resources unless
41
-
`Docker.app` connects to it, so it's safe to ignore.
42
-
43
25
### Where does Docker Desktop store Linux containers and images?
44
26
45
27
Docker Desktop stores Linux containers and images in a single, large "disk image" file in the Mac filesystem. This is different from Docker on Linux, which usually stores containers and images in the `/var/lib/docker` directory.
Copy file name to clipboardExpand all lines: content/manuals/desktop/troubleshoot-and-support/troubleshoot/known-issues.md
-6Lines changed: 0 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,9 +9,6 @@ aliases:
9
9
---
10
10
11
11
{{< tabs >}}
12
-
{{< tab name="For all platforms" >}}
13
-
* IPv6 is not yet supported on Docker Desktop.
14
-
{{< /tab >}}
15
12
{{< tab name="For Mac with Intel chip" >}}
16
13
* The Mac Activity Monitor reports that Docker is using twice the amount of memory it's actually using. This is due to a bug in MacOS. We have written [a detailed report](https://docs.google.com/document/d/17ZiQC1Tp9iH320K-uqVLyiJmk4DHJ3c4zgQetJiKYQM/edit?usp=sharing) on this.
17
14
@@ -20,8 +17,6 @@ aliases:
20
17
the Activity Monitor, and for some processes to consume a large amount of CPU
21
18
resources. Reboot and restart Docker to resolve these issues.
22
19
23
-
* Docker doesn't auto-start after sign in even when it's enabled in **Settings**. This is related to a set of issues with Docker helper, registration, and versioning.
24
-
25
20
* Docker Desktop uses the `HyperKit` hypervisor
26
21
(https://github.com/docker/hyperkit) in macOS 10.10 Yosemite and higher. If
27
22
you are developing with tools that have conflicts with `HyperKit`, such as
@@ -73,7 +68,6 @@ aliases:
73
68
However, attempts to run Intel-based containers on Apple silicon machines under emulation can crash as qemu sometimes fails to run the container. In addition, filesystem change notification APIs (`inotify`) do not work under qemu emulation. Even when the containers do run correctly under emulation, they will be slower and use more memory than the native equivalent.
74
69
75
70
In summary, running Intel-based containers on Arm-based machines should be regarded as "best effort" only. We recommend running arm64 containers on Apple silicon machines whenever possible, and encouraging container authors to produce arm64, or multi-arch, versions of their containers. This issue should become less common over time, as more and more images are rebuilt [supporting multiple architectures](https://www.docker.com/blog/multi-arch-build-and-images-the-simple-way/).
76
-
-`ping` from inside a container to the Internet does not work as expected. To test the network, use `curl` or `wget`. See [docker/for-mac#5322](https://github.com/docker/for-mac/issues/5322#issuecomment-809392861).
77
71
- Users may occasionally experience data drop when a TCP stream is half-closed.
@@ -90,6 +91,37 @@ Enable file sharing in Docker Desktop for Windows:
90
91
1. From **Settings**, select **Shared Folders**.
91
92
2. Share the folder that contains the Dockerfile and volume mount paths.
92
93
94
+
### Issue: `port already allocated` errors
95
+
96
+
#### Error message
97
+
98
+
When starting a container, you may see an error like:
99
+
100
+
```text
101
+
Bind for 0.0.0.0:8080 failed: port is already allocated
102
+
```
103
+
104
+
Or
105
+
106
+
```text
107
+
listen tcp:0.0.0.0:8080: bind: address is already in use
108
+
```
109
+
110
+
#### Cause
111
+
112
+
- Another application on your system is already using the specified port.
113
+
- A previously running container was not stopped properly and is still bound to the port.
114
+
115
+
#### Solution
116
+
117
+
To discover the identity of this software, either:
118
+
- Use the `resmon.exe` GUI, select **Network** and then **Listening Ports**
119
+
- In PowerShell, use `netstat -aon | find /i "listening "` to discover the PID of the process
120
+
currently using the port (the PID is the number in the rightmost column).
121
+
122
+
Then, decide whether to shut the other process down, or to use a different port in your
123
+
Docker app.
124
+
93
125
## Topics for Linux and Mac
94
126
95
127
### Issue: Docker Desktop fails to start on Mac or Linux platforms
@@ -124,6 +156,26 @@ Ensure your username is short enough to keep paths within the allowed limit:
124
156
125
157
## Topics for Mac
126
158
159
+
### Issue: Persistent notification telling me an application has changed my Desktop configurations
160
+
161
+
#### Cause
162
+
163
+
You receive this notification because the Configuration integrity check feature has detected that a third-party application has altered your Docker Desktop configuration. This usually happens due to incorrect or missing symlinks. The notification ensures you are aware of these changes so you can review and repair any potential issues to maintain system reliability.
164
+
165
+
Opening the notification presents a pop-up window which provides detailed information about the detected integrity issues.
166
+
167
+
#### Solution
168
+
169
+
If you choose to ignore the notification, it will be shown again only at the next Docker Desktop startup. If you choose to repair your configuration, you won't be prompted again.
170
+
171
+
If you want to switch off Configuration integrity check notifications, navigate to Docker Desktop's settings and in the **General** tab, clear the **Automatically check configuration** setting.
172
+
173
+
### Issue: `com.docker.vmnetd` is still running after I quit the app
174
+
175
+
The privileged helper process `com.docker.vmnetd` is started by `launchd` and
176
+
runs in the background. The process does not consume any resources unless
177
+
`Docker.app` connects to it, so it's safe to ignore.
178
+
127
179
### Issue: Incompatible CPU detected
128
180
129
181
#### Solution
@@ -169,6 +221,20 @@ To continue using VPNKit:
169
221
170
222
## Topics for Windows
171
223
224
+
### Issue: Docker Desktop fails to start when anti-virus software is installed
225
+
226
+
#### Cause
227
+
228
+
Some anti-virus software may be incompatible with Hyper-V and Microsoft
229
+
Windows 10 builds. The conflict
230
+
typically occurs after a Windows update and
231
+
manifests as an error response from the Docker daemon and a Docker Desktop start failure.
232
+
233
+
#### Solution
234
+
235
+
For a temporary workaround, uninstall the anti-virus software, or
236
+
add Docker to the exclusions/exceptions in your antivirus software.
237
+
172
238
### Issue: Permissions errors on data directories for shared volumes
0 commit comments