Skip to content

Commit 0abd452

Browse files
author
paigehargrave
authored
Update troubleshoot.md
1 parent 014f789 commit 0abd452

File tree

1 file changed

+27
-27
lines changed

1 file changed

+27
-27
lines changed

docker-for-mac/troubleshoot.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -7,21 +7,21 @@ title: Logs and troubleshooting
77
---
88

99
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,
1111
browse and log issues on GitHub, and find workarounds for known problems.
1212

1313
## Docker Knowledge Hub
1414

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
1616
Hub](http://success.docker.com/) for knowledge base articles, FAQs, and
1717
technical support for various subscription levels.
1818

1919
## Diagnose problems, send feedback, and create GitHub issues
2020

2121
### In-app diagnostics
2222
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
2525
forum](https://forums.docker.com/c/docker-for-mac), we can help you troubleshoot
2626
the log data.
2727

@@ -39,7 +39,7 @@ Desktop](https://docs.docker.com/docker-for-mac/faqs/#how-is-personal-data-handl
3939
![Diagnostics & Feedback with
4040
ID](images/diagnose-feedback-id.png){:width="600px"}
4141

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
4343
GitHub](https://github.com/docker/for-mac/issues/) in your web browser in a
4444
"create new issue" template, to be completed before submission. Do not forget to
4545
copy/paste your diagnostic ID.
@@ -49,9 +49,9 @@ copy/paste your diagnostic ID.
4949
### Diagnosing from the terminal
5050

5151
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.
5353

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
5555
the Applications directory, then it is
5656
`/Applications/Docker.app/Contents/MacOS/com.docker.diagnose`.
5757

@@ -89,7 +89,7 @@ documentation](v17.12/docker-for-mac/troubleshoot/#logs).
8989

9090
#### In a terminal
9191

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
9393
your favorite shell.
9494

9595
```bash
@@ -127,7 +127,7 @@ ways, and create reports.
127127

128128
### Make sure certificates are set up correctly
129129

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
131131
not send client certificates to them. Commands like `docker run` that attempt to
132132
pull from the registry produces error messages on the command line, like this:
133133

@@ -145,9 +145,9 @@ As well as on the registry. For example:
145145
For more about using client and server side certificates, see [Adding TLS
146146
certificates](index.md#adding-tls-certificates) in the Getting Started topic.
147147

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
149149

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
151151
account?](faqs.md#do-i-need-to-reinstall-docker-for-mac-if-i-change-the-name-of-my-macos-account)
152152
in the FAQs.
153153

@@ -165,10 +165,10 @@ Dockerfile and volume.
165165

166166
### Incompatible CPU detected
167167

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
169169
specifically, the [Apple Hypervisor
170170
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
172172
Hypervisor framework. Most Macs built in 2010 and later support it, as described
173173
in the Apple Hypervisor Framework documentation about supported hardware:
174174

@@ -189,15 +189,15 @@ If not, the command prints `kern.hv_support: 0`.
189189

190190
See also, [Hypervisor Framework
191191
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
193193
know before you install](install.md#what-to-know-before-you-install).
194194

195195

196196
### Workarounds for common problems
197197

198-
* If Docker for Mac fails to install or start properly:
198+
* If Docker Desktop for Mac fails to install or start properly:
199199

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
201201
application (![whale menu](images/whale-x.png){: .inline} → **Quit
202202
Docker**). Otherwise, you get an "application in use" error when you try to
203203
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).
216216
* If you use bash, use the following command: `unset ${!DOCKER_*}`
217217

218218
* 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
221221
vs. Docker Toolbox](docker-toolbox.md).
222222

223223

@@ -226,13 +226,13 @@ know before you install](install.md#what-to-know-before-you-install).
226226
incoming connections so that the VM can get an IP address.
227227

228228

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
230230
the webserver on `http://localhost/`. Make sure that the Docker whale is
231231
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).
233233
Otherwise, you might start the webserver container but get a "web page not
234234
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
236236
Toolbox](docker-toolbox.md).
237237

238238
<p></p>
@@ -249,12 +249,12 @@ know before you install](install.md#what-to-know-before-you-install).
249249

250250
## Known issues
251251

252-
* IPv6 is not (yet) supported on Docker for Mac.
252+
* IPv6 is not (yet) supported on Docker Desktop for Mac.
253253

254254
A workaround is provided that auto-filters out the IPv6 addresses in DNS
255255
server lists and enables successful network access. For example,
256256
`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:
258258

259259
* [Network timeout when top two DNS servers in /etc/resolv.conf are IPv6
260260
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).
264264

265265
<p></p>
266266

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
268268
(`ValueError: Extra Data`). We've identified this is likely related to data
269269
and/or events being passed all at once rather than one by one, so sometimes
270270
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).
280280

281281
<p></p>
282282

283-
* Docker for Mac uses the `HyperKit` hypervisor
283+
* Docker Desktop for Mac uses the `HyperKit` hypervisor
284284
(https://github.com/docker/hyperkit) in macOS 10.10 Yosemite and higher. If
285285
you are developing with tools that have conflicts with `HyperKit`, such as
286286
[Intel Hardware Accelerated Execution Manager
287287
(HAXM)](https://software.intel.com/en-us/android/articles/intel-hardware-accelerated-execution-manager/),
288288
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.
290290
This allows you to continue work with the other tools and prevent `HyperKit`
291291
from interfering.
292292

@@ -340,7 +340,7 @@ know before you install](install.md#what-to-know-before-you-install).
340340
and roadmap](osxfs.md#performance-issues-solutions-and-roadmap).
341341

342342
* 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.
344344
Furthermore, the time may slowly drift out of sync during use. To manually
345345
reset the time after hibernation, run:
346346

0 commit comments

Comments
 (0)