@@ -8,12 +8,12 @@ title: Logs and troubleshooting
88---
99
1010Here 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
1212Hub, 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
1717Hub] ( http://success.docker.com/q ) for knowledge base articles, FAQs, and
1818technical support for various subscription levels.
1919
@@ -22,7 +22,7 @@ technical support for various subscription levels.
2222### In-app diagnostics
2323
2424If 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
2626GitHub] ( https://github.com/docker/for-win/issues ) , or the [ Docker for Win
2727forum] ( https://forums.docker.com/c/docker-for-windows ) , we can help you
2828troubleshoot 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
4545GitHub] ( 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
4747include your diagnostic ID.
@@ -51,7 +51,7 @@ include your diagnostic ID.
5151### Diagnosing from the terminal
5252
5353On 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
5656First locate the ` com.docker.diagnose ` , that should be in `C:\Program
5757Files\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
7878does not send client certificates to them. Commands like ` docker run ` that
7979attempt to pull from the registry produces error messages on the command line,
8080like 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 )
103103to 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
109109volumes or find a way to make the applications work with the default file
110110permissions.
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
114114protocol] ( https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx ) ,
115115which 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,
127127for example, when an application needs to read/write to a container across a
128128mounted drive. Instead of relying on filesystem inotify, we recommend using
129129polling 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
216216You 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
219219protocols] ( https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx )
220220to 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
245245If 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
2912911 . [ 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
302302it for you.
303303
304304See [ these
305305instructions] ( https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install )
306306to 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,
308308Virtualization needs to be enabled in the BIOS. The steps to do so are Vendor
309309specific, 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 ) {:
322322target="_ blank" class="_ "}, and the [ Microsoft Hyper-V
323323driver] ( /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
325325to create multiple local VMs, or to provision remote machines, see the [ Docker
326326Machine] ( /machine/index.md ) topics. We mention this here only in case someone is
327327looking 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
339339If, 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
341341Windows 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
345345Some 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
347347and/or WiFi gets disabled. In some scenarios, problems are due to having
348348VirtualBox 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
350350Hyper-V feature turns my wi-fi
351351off] ( 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
392392Containers] ( https://github.com/docker/labs/blob/master/windows/windows-containers/README.md ) .
393393
394394You 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
396396this way, you cannot develop or run Linux containers. If you try to run a Linux
397397container 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.
408408If you are using Windows containers, keep in mind that there are some
409409limitations with regard to networking due to the current implementation of
410410Windows 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
460460For 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
475475apps like Parallels or VMware Fusion on a Mac provided that the VM is properly
476476configured. However, problems and intermittent failures may still occur due to
477477the way these apps virtualize the hardware. For these reasons, _ ** Docker for
478478Windows is not supported for nested virtualization scenarios** _ . It might work
479479in 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
483483with 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
553553the prefix from the ** Settings** menu. See the [Network](index.md#network) topic
554554under [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
560560If you are using ` Node.js` with ` nodemon` , a temporary workaround is to try the
561561fallback 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
580580running to get to the webserver on ` http://localhost/` . Make sure that the
581581Docker 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
583583Toolbox). Otherwise, you might start the webserver container but get a " web page
584584not 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
603603typically 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
605605start failure** . The Comodo Firewall was one example of this problem, but users
606606report that software has since been updated to work with these Windows 10
607607builds.
@@ -610,7 +610,7 @@ See the Comodo forums topics [Comodo Firewall conflict with
610610Hyper-V](https://forums.comodo.com/bug-reports-cis/comodo-firewall-began-conflict-with-hyperv-t116351.0.html)
611611and [Windows 10 Anniversary build doesn' t allow Comodo drivers to be
612612installed](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
614614relates to Docker: [Docker fails to start on Windows
61561510](https://github.com/docker/for-win/issues/27).
616616
0 commit comments