Skip to content

Commit e872839

Browse files
author
paigehargrave
authored
Update troubleshoot.md
1 parent 9a2ae6b commit e872839

File tree

1 file changed

+34
-34
lines changed

1 file changed

+34
-34
lines changed

docker-for-windows/troubleshoot.md

+34-34
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,12 @@ title: Logs and troubleshooting
88
---
99

1010
Here is information about how to diagnose and troubleshoot problems, send logs
11-
and communicate with the Docker for Windows team, use our forums and Knowledge
11+
and communicate with the Docker Desktop for Windows team, use our forums and Knowledge
1212
Hub, browse and log issues on GitHub, and find workarounds for known problems.
1313

1414
## Docker Knowledge Hub
1515

16-
**Looking for help with Docker for Windows?** Check out the [Docker Knowledge
16+
**Looking for help with Docker Desktop for Windows?** Check out the [Docker Knowledge
1717
Hub](http://success.docker.com/q) for knowledge base articles, FAQs, and
1818
technical support for various subscription levels.
1919

@@ -22,7 +22,7 @@ technical support for various subscription levels.
2222
### In-app diagnostics
2323

2424
If you encounter problems for which you do not find solutions in this
25-
documentation, on [Docker for Windows issues on
25+
documentation, on [Docker Desktop for Windows issues on
2626
GitHub](https://github.com/docker/for-win/issues), or the [Docker for Win
2727
forum](https://forums.docker.com/c/docker-for-windows), we can help you
2828
troubleshoot the log data.
@@ -41,7 +41,7 @@ Desktop](https://docs.docker.com/docker-for-mac/faqs/#how-is-personal-data-handl
4141

4242
![Diagnose & Feedback with ID](images/diagnostic-id.png){:width="600px"}
4343

44-
If you click on **Report an issue**, this opens [Docker for Windows issues on
44+
If you click on **Report an issue**, this opens [Docker Desktop for Windows issues on
4545
GitHub](https://github.com/docker/for-win/issues/) in your web browser in a
4646
"create new issue" template, to be completed before submision. Do not forget to
4747
include your diagnostic ID.
@@ -51,7 +51,7 @@ include your diagnostic ID.
5151
### Diagnosing from the terminal
5252

5353
On occasions it is useful to run the diagnostics yourself, for instance if
54-
Docker for Windows cannot start.
54+
Docker Desktop for Windows cannot start.
5555

5656
First locate the `com.docker.diagnose`, that should be in `C:\Program
5757
Files\Docker\Docker\resources\com.docker.diagnose.exe`.
@@ -74,7 +74,7 @@ Diagnostics ID: CD6CF862-9CBD-4007-9C2F-5FBE0572BBC2/20180720152545 (uploade
7474

7575
### Make sure certificates are set up correctly
7676

77-
Docker for Windows ignores certificates listed under insecure registries, and
77+
Docker Desktop for Windows ignores certificates listed under insecure registries, and
7878
does not send client certificates to them. Commands like `docker run` that
7979
attempt to pull from the registry produces error messages on the command line,
8080
like this:
@@ -99,7 +99,7 @@ Getting Started topic.
9999

100100
#### Permissions errors on data directories for shared volumes
101101

102-
Docker for Windows sets permissions on [shared volumes](index.md#shared-drives)
102+
Docker Desktop for Windows sets permissions on [shared volumes](index.md#shared-drives)
103103
to a default value of [0777](http://permissions-calculator.org/decode/0777/)
104104
(`read`, `write`, `execute` permissions for `user` and for `group`).
105105

@@ -109,7 +109,7 @@ volume defaults at container runtime, you need to either use non-host-mounted
109109
volumes or find a way to make the applications work with the default file
110110
permissions.
111111

112-
Docker for Windows currrently implements host-mounted volumes based on the
112+
Docker Desktop for Windows currrently implements host-mounted volumes based on the
113113
[Microsoft SMB
114114
protocol](https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx),
115115
which does not support fine-grained, `chmod` control over these permissions.
@@ -123,7 +123,7 @@ drives](https://github.com/docker/docker.github.io/issues/3298).
123123

124124
#### inotify on shared drives does not work
125125

126-
Currently, `inotify` does not work on Docker for Windows. This becomes evident,
126+
Currently, `inotify` does not work on Docker Desktop for Windows. This becomes evident,
127127
for example, when an application needs to read/write to a container across a
128128
mounted drive. Instead of relying on filesystem inotify, we recommend using
129129
polling features for your framework or programming language.
@@ -133,7 +133,7 @@ polling features for your framework or programming language.
133133
polling mode described here: [nodemon isn't restarting node
134134
applications](https://github.com/remy/nodemon#application-isnt-restarting)
135135

136-
* **Docker for Windows issue on GitHub** - See the issue [Inotify on shared
136+
* **Docker Desktop for Windows issue on GitHub** - See the issue [Inotify on shared
137137
drives does not
138138
work](https://github.com/docker/for-win/issues/56#issuecomment-242135705)
139139

@@ -214,7 +214,7 @@ container](https://github.com/docker/for-win/issues/25).
214214
#### Volume mounts from host paths use a `nobrl` option to override database locking
215215

216216
You may encounter problems using volume mounts on the host, depending on the
217-
database software and which options are enabled. Docker for Windows uses
217+
database software and which options are enabled. Docker Desktop for Windows uses
218218
[SMB/CIFS
219219
protocols](https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx)
220220
to mount host paths, and mounts them with the `nobrl` option, which prevents
@@ -239,7 +239,7 @@ Compose file documentation.
239239

240240
#### Local security policies can block shared drives and cause login errors
241241

242-
You need permissions to mount shared drives to use the Docker for Windows
242+
You need permissions to mount shared drives to use the Docker Desktop for Windows
243243
[shared drives](index.md#shared-drives) feature.
244244

245245
If local policy prevents this, you get errors when you attempt to enable shared
@@ -286,7 +286,7 @@ script](https://github.com/moby/moby/issues/24388).
286286

287287
### Virtualization
288288

289-
In order for Docker for Windows to function properly your machine needs:
289+
In order for Docker Desktop for Windows to function properly your machine needs:
290290

291291
1. [Hyper-V](https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-technology-overview)
292292
installed and working
@@ -297,14 +297,14 @@ In order for Docker for Windows to function properly your machine needs:
297297
#### Hyper-V
298298

299299

300-
Docker for Windows requires a Hyper-V as well as the Hyper-V Module for Windows
301-
Powershell to be installed and enabled. The Docker for Windows installer enables
300+
Docker Desktop for Windows requires a Hyper-V as well as the Hyper-V Module for Windows
301+
Powershell to be installed and enabled. The Docker Desktop for Windows installer enables
302302
it for you.
303303

304304
See [these
305305
instructions](https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install)
306306
to install Hyper-V manually. A reboot is *required*. If you install Hyper-V
307-
without the reboot, Docker for Windows does not work correctly. On some systems,
307+
without the reboot, Docker Desktop for Windows does not work correctly. On some systems,
308308
Virtualization needs to be enabled in the BIOS. The steps to do so are Vendor
309309
specific, but typically the BIOS option is called `Virtualization Technology
310310
(VTx)` or similar.
@@ -317,11 +317,11 @@ In the subequent screen, verify Hyper-V is enabled and has a checkmark:
317317

318318
#### Hyper-V driver for Docker Machine
319319

320-
Docker for Windows comes with the legacy tool Docker Machine which uses the old
320+
Docker Desktop for Windows comes with the legacy tool Docker Machine which uses the old
321321
[`boot2docker.iso`](https://github.com/boot2docker/boot2docker){:
322322
target="_blank" class="_"}, and the [Microsoft Hyper-V
323323
driver](/machine/drivers/hyper-v.md) to create local virtual machines. _This is
324-
tangential to using Docker for Windows_, but if you want to use Docker Machine
324+
tangential to using Docker Desktop for Windows_, but if you want to use Docker Machine
325325
to create multiple local VMs, or to provision remote machines, see the [Docker
326326
Machine](/machine/index.md) topics. We mention this here only in case someone is
327327
looking for information about Docker Machine on Windows, which requires that
@@ -337,16 +337,16 @@ Performance tab on the Task Manager:
337337
![Task Manager](images/virtualization-enabled.png){:width="700px"}
338338

339339
If, at some point, if you manually uninstall Hyper-V or disable virtualization,
340-
Docker for Windows cannot start. See: [Unable to run Docker for Windows on
340+
Docker Desktop for Windows cannot start. See: [Unable to run Docker for Windows on
341341
Windows 10 Enterprise](https://github.com/docker/for-win/issues/74).
342342

343-
### Networking and WiFi problems upon Docker for Windows install
343+
### Networking and WiFi problems upon Docker Desktop for Windows install
344344

345345
Some users have encountered networking issues during install and startup of
346-
Docker for Windows. For example, upon install or auto-reboot, network adapters
346+
Docker Desktop for Windows. For example, upon install or auto-reboot, network adapters
347347
and/or WiFi gets disabled. In some scenarios, problems are due to having
348348
VirtualBox or its network adapters still installed, but in other scenarios this
349-
is not the case. (See also, Docker for Windows issue on GitHub: [Enabling
349+
is not the case. (See also, Docker Desktop for Windows issue on GitHub: [Enabling
350350
Hyper-V feature turns my wi-fi
351351
off](https://github.com/docker/for-win/issues/139).)
352352

@@ -392,7 +392,7 @@ A full tutorial is available in [docker/labs](https://github.com/docker/labs) at
392392
Containers](https://github.com/docker/labs/blob/master/windows/windows-containers/README.md).
393393

394394
You can install a native Windows binary which allows you to develop and run
395-
Windows containers without Docker for Windows. However, if you install Docker
395+
Windows containers without Docker Desktop for Windows. However, if you install Docker
396396
this way, you cannot develop or run Linux containers. If you try to run a Linux
397397
container on the native Docker daemon, an error occurs:
398398

@@ -404,7 +404,7 @@ C:\Program Files\Docker\docker.exe:
404404

405405
### Limitations of Windows containers for `localhost` and published ports
406406

407-
Docker for Windows provides the option to switch Windows and Linux containers.
407+
Docker Desktop for Windows provides the option to switch Windows and Linux containers.
408408
If you are using Windows containers, keep in mind that there are some
409409
limitations with regard to networking due to the current implementation of
410410
Windows NAT (WinNAT). These limitations may potentially resolve as the Windows
@@ -459,7 +459,7 @@ Now you can connect to the webserver by using `http://172.17.0.2:80` (or simply
459459

460460
For more information, see:
461461

462-
* Docker for Windows issue on GitHub: [Port binding does not work for
462+
* Docker Desktop for Windows issue on GitHub: [Port binding does not work for
463463
locahost](https://github.com/docker/for-win/issues/458)
464464

465465
* [Published Ports on Windows Containers Don't Do
@@ -469,16 +469,16 @@ For more information, see:
469469
limitations](https://blogs.technet.microsoft.com/virtualization/2016/05/25/windows-nat-winnat-capabilities-and-limitations/)
470470

471471

472-
### Running Docker for Windows in nested virtualization scenarios
472+
### Running Docker Desktop for Windows in nested virtualization scenarios
473473

474-
Docker for Windows can run inside a Windows 10 virtual machine (VM) running on
474+
Docker Desktop for Windows can run inside a Windows 10 virtual machine (VM) running on
475475
apps like Parallels or VMware Fusion on a Mac provided that the VM is properly
476476
configured. However, problems and intermittent failures may still occur due to
477477
the way these apps virtualize the hardware. For these reasons, _**Docker for
478478
Windows is not supported for nested virtualization scenarios**_. It might work
479479
in some cases, and not in others.
480480

481-
The better solution is to run Docker for Windows natively on a Windows system
481+
The better solution is to run Docker Desktop for Windows natively on a Windows system
482482
(to work with Windows or Linux containers), or Docker for Mac on Mac to work
483483
with Linux containers.
484484

@@ -548,14 +548,14 @@ We are currently investigating this issue.
548548
549549
### NAT/IP configuration
550550
551-
By default, Docker for Windows uses an internal network prefix of
551+
By default, Docker Desktop for Windows uses an internal network prefix of
552552
`10.0.75.0/24`. Should this clash with your normal network setup, you can change
553553
the prefix from the **Settings** menu. See the [Network](index.md#network) topic
554554
under [Settings](index.md#docker-settings).
555555
556556
## Workarounds
557557
558-
### `inotify` currently does not work on Docker for Windows
558+
### `inotify` currently does not work on Docker Desktop for Windows
559559
560560
If you are using `Node.js` with `nodemon`, a temporary workaround is to try the
561561
fallback polling mode described here: [nodemon isn't restarting node
@@ -576,10 +576,10 @@ consult the shell's documentation.
576576
577577
### Make sure Docker is running for webserver examples
578578
579-
For the `hello-world-nginx` example and others, Docker for Windows must be
579+
For the `hello-world-nginx` example and others, Docker Desktop for Windows must be
580580
running to get to the webserver on `http://localhost/`. Make sure that the
581581
Docker whale is showing in the menu bar, and that you run the Docker commands in
582-
a shell that is connected to the Docker for Windows Engine (not Engine from
582+
a shell that is connected to the Docker Desktop for Windows Engine (not Engine from
583583
Toolbox). Otherwise, you might start the webserver container but get a "web page
584584
not available" error when you go to `docker`.
585585
@@ -601,7 +601,7 @@ docker app.
601601
**Some firewalls and anti-virus software might be incompatible with Microsoft
602602
**Windows 10 builds**, such as Windows 10 Anniversary Update. The conflict
603603
typically occurs after a Windows update or new install of the firewall, and
604-
manifests as an error response from the Docker daemon and a **Docker for Windows
604+
manifests as an error response from the Docker daemon and a **Docker Desktop for Windows
605605
start failure**. The Comodo Firewall was one example of this problem, but users
606606
report that software has since been updated to work with these Windows 10
607607
builds.
@@ -610,7 +610,7 @@ See the Comodo forums topics [Comodo Firewall conflict with
610610
Hyper-V](https://forums.comodo.com/bug-reports-cis/comodo-firewall-began-conflict-with-hyperv-t116351.0.html)
611611
and [Windows 10 Anniversary build doesn't allow Comodo drivers to be
612612
installed](https://forums.comodo.com/install-setup-configuration-help-cis/windows-10-aniversary-build-doesnt-allow-comodo-drivers-to-be-installed-t116322.0.html).
613-
A Docker for Windows user-created issue describes the problem specifically as it
613+
A Docker Desktop for Windows user-created issue describes the problem specifically as it
614614
relates to Docker: [Docker fails to start on Windows
615615
10](https://github.com/docker/for-win/issues/27).
616616

0 commit comments

Comments
 (0)