@@ -7,21 +7,21 @@ title: Logs and troubleshooting
7
7
---
8
8
9
9
Here is information about how to diagnose and troubleshoot problems, send logs
10
- and communicate with the Docker for Mac team, use our forums and Knowledge Hub,
10
+ and communicate with the Docker Desktop for Mac team, use our forums and Knowledge Hub,
11
11
browse and log issues on GitHub, and find workarounds for known problems.
12
12
13
13
## Docker Knowledge Hub
14
14
15
- ** Looking for help with Docker for Mac?** Check out the [ Docker Knowledge
15
+ ** Looking for help with Docker Desktop for Mac?** Check out the [ Docker Knowledge
16
16
Hub] ( http://success.docker.com/ ) for knowledge base articles, FAQs, and
17
17
technical support for various subscription levels.
18
18
19
19
## Diagnose problems, send feedback, and create GitHub issues
20
20
21
21
### In-app diagnostics
22
22
If you encounter problems for which you do not find solutions in this
23
- documentation, on [ Docker for Mac issues on
24
- GitHub] ( https://github.com/docker/for-mac/issues ) , or the [ Docker for Mac
23
+ documentation, on [ Docker Desktop for Mac issues on
24
+ GitHub] ( https://github.com/docker/for-mac/issues ) , or the [ Docker Desktop for Mac
25
25
forum] ( https://forums.docker.com/c/docker-for-mac ) , we can help you troubleshoot
26
26
the log data.
27
27
@@ -39,7 +39,7 @@ Desktop](https://docs.docker.com/docker-for-mac/faqs/#how-is-personal-data-handl
39
39
![ Diagnostics & Feedback with
40
40
ID] ( images/diagnose-feedback-id.png ) {: width ="600px"}
41
41
42
- If you click ** Report an issue** , this opens [ Docker for Mac issues on
42
+ If you click ** Report an issue** , this opens [ Docker Desktop for Mac issues on
43
43
GitHub] ( https://github.com/docker/for-mac/issues/ ) in your web browser in a
44
44
"create new issue" template, to be completed before submission. Do not forget to
45
45
copy/paste your diagnostic ID.
@@ -49,9 +49,9 @@ copy/paste your diagnostic ID.
49
49
### Diagnosing from the terminal
50
50
51
51
On occasions it is useful to run the diagnostics yourself, for instance if
52
- Docker for Mac cannot start.
52
+ Docker Desktop for Mac cannot start.
53
53
54
- First locate the ` com.docker.diagnose ` tool. If you installed Docker for Mac in
54
+ First locate the ` com.docker.diagnose ` tool. If you installed Docker Desktop for Mac in
55
55
the Applications directory, then it is
56
56
` /Applications/Docker.app/Contents/MacOS/com.docker.diagnose ` .
57
57
@@ -89,7 +89,7 @@ documentation](v17.12/docker-for-mac/troubleshoot/#logs).
89
89
90
90
#### In a terminal
91
91
92
- To watch the live flow of Docker for Mac logs at the command line, run this from
92
+ To watch the live flow of Docker Desktop for Mac logs at the command line, run this from
93
93
your favorite shell.
94
94
95
95
``` bash
@@ -127,7 +127,7 @@ ways, and create reports.
127
127
128
128
### Make sure certificates are set up correctly
129
129
130
- Docker for Mac ignores certificates listed under insecure registries, and does
130
+ Docker Desktop for Mac ignores certificates listed under insecure registries, and does
131
131
not send client certificates to them. Commands like ` docker run ` that attempt to
132
132
pull from the registry produces error messages on the command line, like this:
133
133
@@ -145,9 +145,9 @@ As well as on the registry. For example:
145
145
For more about using client and server side certificates, see [ Adding TLS
146
146
certificates] ( index.md#adding-tls-certificates ) in the Getting Started topic.
147
147
148
- ### Docker for Mac does not start if Mac user account and home folder are renamed after installing the app
148
+ ### Docker Desktop for Mac does not start if Mac user account and home folder are renamed after installing the app
149
149
150
- See [ Do I need to reinstall Docker for Mac if I change the name of my macOS
150
+ See [ Do I need to reinstall Docker Desktop for Mac if I change the name of my macOS
151
151
account?] ( faqs.md#do-i-need-to-reinstall-docker-for-mac-if-i-change-the-name-of-my-macos-account )
152
152
in the FAQs.
153
153
@@ -165,10 +165,10 @@ Dockerfile and volume.
165
165
166
166
### Incompatible CPU detected
167
167
168
- Docker for Mac requires a processor (CPU) that supports virtualization and, more
168
+ Docker Desktop for Mac requires a processor (CPU) that supports virtualization and, more
169
169
specifically, the [ Apple Hypervisor
170
170
framework] ( https://developer.apple.com/library/mac/documentation/DriversKernelHardware/Reference/Hypervisor/ ) .
171
- Docker for Mac is only compatible with Macs that have a CPU that supports the
171
+ Docker Desktop for Mac is only compatible with Macs that have a CPU that supports the
172
172
Hypervisor framework. Most Macs built in 2010 and later support it, as described
173
173
in the Apple Hypervisor Framework documentation about supported hardware:
174
174
@@ -189,15 +189,15 @@ If not, the command prints `kern.hv_support: 0`.
189
189
190
190
See also, [ Hypervisor Framework
191
191
Reference] ( https://developer.apple.com/library/mac/documentation/DriversKernelHardware/Reference/Hypervisor/ )
192
- in the Apple documentation, and Docker for Mac system requirements in [ What to
192
+ in the Apple documentation, and Docker Desktop for Mac system requirements in [ What to
193
193
know before you install] ( install.md#what-to-know-before-you-install ) .
194
194
195
195
196
196
### Workarounds for common problems
197
197
198
- * If Docker for Mac fails to install or start properly:
198
+ * If Docker Desktop for Mac fails to install or start properly:
199
199
200
- * Make sure you quit Docker for Mac before installing a new version of the
200
+ * Make sure you quit Docker Desktop for Mac before installing a new version of the
201
201
application (![ whale menu] ( images/whale-x.png ) {: .inline} → ** Quit
202
202
Docker** ). Otherwise, you get an "application in use" error when you try to
203
203
copy the new app from the ` .dmg ` to ` /Applications ` .
@@ -216,8 +216,8 @@ know before you install](install.md#what-to-know-before-you-install).
216
216
* If you use bash, use the following command: ` unset ${!DOCKER_*} `
217
217
218
218
* For other shells, unset each environment variable individually as described
219
- in [ Setting up to run Docker for
220
- Mac] ( docker-toolbox.md#setting-up-to-run-docker-for-mac ) in [ Docker for Mac
219
+ in [ Setting up to run Docker Desktop for
220
+ Mac] ( docker-toolbox.md#setting-up-to-run-docker-for-mac ) in [ Docker Desktop for Mac
221
221
vs. Docker Toolbox] ( docker-toolbox.md ) .
222
222
223
223
@@ -226,13 +226,13 @@ know before you install](install.md#what-to-know-before-you-install).
226
226
incoming connections so that the VM can get an IP address.
227
227
228
228
229
- * For the ` hello-world-nginx ` example, Docker for Mac must be running to get to
229
+ * For the ` hello-world-nginx ` example, Docker Desktop for Mac must be running to get to
230
230
the webserver on ` http://localhost/ ` . Make sure that the Docker whale is
231
231
showing in the menu bar, and that you run the Docker commands in a shell that
232
- is connected to the Docker for Mac Engine (not Engine from Toolbox).
232
+ is connected to the Docker Desktop for Mac Engine (not Engine from Toolbox).
233
233
Otherwise, you might start the webserver container but get a "web page not
234
234
available" error when you go to ` localhost ` . For more on distinguishing
235
- between the two environments, see [ Docker for Mac vs. Docker
235
+ between the two environments, see [ Docker Desktop for Mac vs. Docker
236
236
Toolbox] ( docker-toolbox.md ) .
237
237
238
238
<p ></p >
@@ -249,12 +249,12 @@ know before you install](install.md#what-to-know-before-you-install).
249
249
250
250
## Known issues
251
251
252
- * IPv6 is not (yet) supported on Docker for Mac.
252
+ * IPv6 is not (yet) supported on Docker Desktop for Mac.
253
253
254
254
A workaround is provided that auto-filters out the IPv6 addresses in DNS
255
255
server lists and enables successful network access. For example,
256
256
` 2001:4860:4860::8888 ` would become ` 8.8.8.8 ` . To learn more, see these
257
- issues on GitHub and Docker for Mac forums:
257
+ issues on GitHub and Docker Desktop for Mac forums:
258
258
259
259
* [ Network timeout when top two DNS servers in /etc/resolv.conf are IPv6
260
260
addresses] ( https://github.com/docker/for-mac/issues/9 )
@@ -264,7 +264,7 @@ know before you install](install.md#what-to-know-before-you-install).
264
264
265
265
<p ></p >
266
266
267
- * You might encounter errors when using ` docker-compose up ` with Docker for Mac
267
+ * You might encounter errors when using ` docker-compose up ` with Docker Desktop for Mac
268
268
(` ValueError: Extra Data ` ). We've identified this is likely related to data
269
269
and/or events being passed all at once rather than one by one, so sometimes
270
270
the data comes back as 2+ objects concatenated and causes an error.
@@ -280,13 +280,13 @@ know before you install](install.md#what-to-know-before-you-install).
280
280
281
281
<p ></p >
282
282
283
- * Docker for Mac uses the ` HyperKit ` hypervisor
283
+ * Docker Desktop for Mac uses the ` HyperKit ` hypervisor
284
284
(https://github.com/docker/hyperkit ) in macOS 10.10 Yosemite and higher. If
285
285
you are developing with tools that have conflicts with ` HyperKit ` , such as
286
286
[ Intel Hardware Accelerated Execution Manager
287
287
(HAXM)] ( https://software.intel.com/en-us/android/articles/intel-hardware-accelerated-execution-manager/ ) ,
288
288
the current workaround is not to run them at the same time. You can pause
289
- ` HyperKit ` by quitting Docker for Mac temporarily while you work with HAXM.
289
+ ` HyperKit ` by quitting Docker Desktop for Mac temporarily while you work with HAXM.
290
290
This allows you to continue work with the other tools and prevent ` HyperKit `
291
291
from interfering.
292
292
@@ -340,7 +340,7 @@ know before you install](install.md#what-to-know-before-you-install).
340
340
and roadmap] ( osxfs.md#performance-issues-solutions-and-roadmap ) .
341
341
342
342
* If your system does not have access to an NTP server, then after a hibernate
343
- the time seen by Docker for Mac may be considerably out of sync with the host.
343
+ the time seen by Docker Desktop for Mac may be considerably out of sync with the host.
344
344
Furthermore, the time may slowly drift out of sync during use. To manually
345
345
reset the time after hibernation, run:
346
346
0 commit comments