@@ -8,12 +8,12 @@ title: Logs and troubleshooting
8
8
---
9
9
10
10
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
12
12
Hub, browse and log issues on GitHub, and find workarounds for known problems.
13
13
14
14
## Docker Knowledge Hub
15
15
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
17
17
Hub] ( http://success.docker.com/q ) for knowledge base articles, FAQs, and
18
18
technical support for various subscription levels.
19
19
@@ -22,7 +22,7 @@ technical support for various subscription levels.
22
22
### In-app diagnostics
23
23
24
24
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
26
26
GitHub] ( https://github.com/docker/for-win/issues ) , or the [ Docker for Win
27
27
forum] ( https://forums.docker.com/c/docker-for-windows ) , we can help you
28
28
troubleshoot the log data.
@@ -41,7 +41,7 @@ Desktop](https://docs.docker.com/docker-for-mac/faqs/#how-is-personal-data-handl
41
41
42
42
![ Diagnose & Feedback with ID] ( images/diagnostic-id.png ) {: width ="600px"}
43
43
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
45
45
GitHub] ( https://github.com/docker/for-win/issues/ ) in your web browser in a
46
46
"create new issue" template, to be completed before submision. Do not forget to
47
47
include your diagnostic ID.
@@ -51,7 +51,7 @@ include your diagnostic ID.
51
51
### Diagnosing from the terminal
52
52
53
53
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.
55
55
56
56
First locate the ` com.docker.diagnose ` , that should be in `C:\Program
57
57
Files\Docker\Docker\resources\com.docker.diagnose.exe`.
@@ -74,7 +74,7 @@ Diagnostics ID: CD6CF862-9CBD-4007-9C2F-5FBE0572BBC2/20180720152545 (uploade
74
74
75
75
### Make sure certificates are set up correctly
76
76
77
- Docker for Windows ignores certificates listed under insecure registries, and
77
+ Docker Desktop for Windows ignores certificates listed under insecure registries, and
78
78
does not send client certificates to them. Commands like ` docker run ` that
79
79
attempt to pull from the registry produces error messages on the command line,
80
80
like this:
@@ -99,7 +99,7 @@ Getting Started topic.
99
99
100
100
#### Permissions errors on data directories for shared volumes
101
101
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 )
103
103
to a default value of [ 0777] ( http://permissions-calculator.org/decode/0777/ )
104
104
(` read ` , ` write ` , ` execute ` permissions for ` user ` and for ` group ` ).
105
105
@@ -109,7 +109,7 @@ volume defaults at container runtime, you need to either use non-host-mounted
109
109
volumes or find a way to make the applications work with the default file
110
110
permissions.
111
111
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
113
113
[ Microsoft SMB
114
114
protocol] ( https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx ) ,
115
115
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).
123
123
124
124
#### inotify on shared drives does not work
125
125
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,
127
127
for example, when an application needs to read/write to a container across a
128
128
mounted drive. Instead of relying on filesystem inotify, we recommend using
129
129
polling features for your framework or programming language.
@@ -133,7 +133,7 @@ polling features for your framework or programming language.
133
133
polling mode described here: [ nodemon isn't restarting node
134
134
applications] ( https://github.com/remy/nodemon#application-isnt-restarting )
135
135
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
137
137
drives does not
138
138
work] ( https://github.com/docker/for-win/issues/56#issuecomment-242135705 )
139
139
@@ -214,7 +214,7 @@ container](https://github.com/docker/for-win/issues/25).
214
214
#### Volume mounts from host paths use a ` nobrl ` option to override database locking
215
215
216
216
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
218
218
[ SMB/CIFS
219
219
protocols] ( https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx )
220
220
to mount host paths, and mounts them with the ` nobrl ` option, which prevents
@@ -239,7 +239,7 @@ Compose file documentation.
239
239
240
240
#### Local security policies can block shared drives and cause login errors
241
241
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
243
243
[ shared drives] ( index.md#shared-drives ) feature.
244
244
245
245
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).
286
286
287
287
### Virtualization
288
288
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:
290
290
291
291
1 . [ Hyper-V] ( https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-technology-overview )
292
292
installed and working
@@ -297,14 +297,14 @@ In order for Docker for Windows to function properly your machine needs:
297
297
#### Hyper-V
298
298
299
299
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
302
302
it for you.
303
303
304
304
See [ these
305
305
instructions] ( https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install )
306
306
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,
308
308
Virtualization needs to be enabled in the BIOS. The steps to do so are Vendor
309
309
specific, but typically the BIOS option is called `Virtualization Technology
310
310
(VTx)` or similar.
@@ -317,11 +317,11 @@ In the subequent screen, verify Hyper-V is enabled and has a checkmark:
317
317
318
318
#### Hyper-V driver for Docker Machine
319
319
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
321
321
[ ` boot2docker.iso ` ] ( https://github.com/boot2docker/boot2docker ) {:
322
322
target="_ blank" class="_ "}, and the [ Microsoft Hyper-V
323
323
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
325
325
to create multiple local VMs, or to provision remote machines, see the [ Docker
326
326
Machine] ( /machine/index.md ) topics. We mention this here only in case someone is
327
327
looking for information about Docker Machine on Windows, which requires that
@@ -337,16 +337,16 @@ Performance tab on the Task Manager:
337
337
![ Task Manager] ( images/virtualization-enabled.png ) {: width ="700px"}
338
338
339
339
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
341
341
Windows 10 Enterprise] ( https://github.com/docker/for-win/issues/74 ) .
342
342
343
- ### Networking and WiFi problems upon Docker for Windows install
343
+ ### Networking and WiFi problems upon Docker Desktop for Windows install
344
344
345
345
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
347
347
and/or WiFi gets disabled. In some scenarios, problems are due to having
348
348
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
350
350
Hyper-V feature turns my wi-fi
351
351
off] ( https://github.com/docker/for-win/issues/139 ) .)
352
352
@@ -392,7 +392,7 @@ A full tutorial is available in [docker/labs](https://github.com/docker/labs) at
392
392
Containers] ( https://github.com/docker/labs/blob/master/windows/windows-containers/README.md ) .
393
393
394
394
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
396
396
this way, you cannot develop or run Linux containers. If you try to run a Linux
397
397
container on the native Docker daemon, an error occurs:
398
398
@@ -404,7 +404,7 @@ C:\Program Files\Docker\docker.exe:
404
404
405
405
### Limitations of Windows containers for ` localhost ` and published ports
406
406
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.
408
408
If you are using Windows containers, keep in mind that there are some
409
409
limitations with regard to networking due to the current implementation of
410
410
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
459
459
460
460
For more information, see:
461
461
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
463
463
locahost] ( https://github.com/docker/for-win/issues/458 )
464
464
465
465
* [ Published Ports on Windows Containers Don't Do
@@ -469,16 +469,16 @@ For more information, see:
469
469
limitations] ( https://blogs.technet.microsoft.com/virtualization/2016/05/25/windows-nat-winnat-capabilities-and-limitations/ )
470
470
471
471
472
- ### Running Docker for Windows in nested virtualization scenarios
472
+ ### Running Docker Desktop for Windows in nested virtualization scenarios
473
473
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
475
475
apps like Parallels or VMware Fusion on a Mac provided that the VM is properly
476
476
configured. However, problems and intermittent failures may still occur due to
477
477
the way these apps virtualize the hardware. For these reasons, _ ** Docker for
478
478
Windows is not supported for nested virtualization scenarios** _ . It might work
479
479
in some cases, and not in others.
480
480
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
482
482
(to work with Windows or Linux containers), or Docker for Mac on Mac to work
483
483
with Linux containers.
484
484
@@ -548,14 +548,14 @@ We are currently investigating this issue.
548
548
549
549
# ## NAT/IP configuration
550
550
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
552
552
` 10.0.75.0/24` . Should this clash with your normal network setup, you can change
553
553
the prefix from the ** Settings** menu. See the [Network](index.md#network) topic
554
554
under [Settings](index.md#docker-settings).
555
555
556
556
# # Workarounds
557
557
558
- # ## `inotify` currently does not work on Docker for Windows
558
+ # ## `inotify` currently does not work on Docker Desktop for Windows
559
559
560
560
If you are using ` Node.js` with ` nodemon` , a temporary workaround is to try the
561
561
fallback polling mode described here: [nodemon isn' t restarting node
@@ -576,10 +576,10 @@ consult the shell's documentation.
576
576
577
577
# ## Make sure Docker is running for webserver examples
578
578
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
580
580
running to get to the webserver on ` http://localhost/` . Make sure that the
581
581
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
583
583
Toolbox). Otherwise, you might start the webserver container but get a " web page
584
584
not available" error when you go to ` docker` .
585
585
@@ -601,7 +601,7 @@ docker app.
601
601
** Some firewalls and anti-virus software might be incompatible with Microsoft
602
602
** Windows 10 builds** , such as Windows 10 Anniversary Update. The conflict
603
603
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
605
605
start failure** . The Comodo Firewall was one example of this problem, but users
606
606
report that software has since been updated to work with these Windows 10
607
607
builds.
@@ -610,7 +610,7 @@ See the Comodo forums topics [Comodo Firewall conflict with
610
610
Hyper-V](https://forums.comodo.com/bug-reports-cis/comodo-firewall-began-conflict-with-hyperv-t116351.0.html)
611
611
and [Windows 10 Anniversary build doesn' t allow Comodo drivers to be
612
612
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
614
614
relates to Docker: [Docker fails to start on Windows
615
615
10](https://github.com/docker/for-win/issues/27).
616
616
0 commit comments