centersl/docker-docs
1
0
Fork 0
mirror of https://github.com/docker/docs.git synced 2026-03-29 23:38:56 +07:00
Code Issues Packages Projects Releases Wiki Activity

Update troubleshoot.md

Browse Source
This commit is contained in:
paigehargrave
2019-01-11 10:11:49 -05:00
committed by GitHub
parent 9a2ae6b9c3
commit e872839aba
1 changed files with 34 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
docker-for-windows/troubleshoot.md
View File

@@ -8,12 +8,12 @@ title: Logs and troubleshooting
---
Here is information about how to diagnose and troubleshoot problems, send logs
and communicate with the Docker for Windows team, use our forums and Knowledge
and communicate with the Docker Desktop for Windows team, use our forums and Knowledge
Hub, browse and log issues on GitHub, and find workarounds for known problems.
## Docker Knowledge Hub
**Looking for help with Docker for Windows?** Check out the [Docker Knowledge
**Looking for help with Docker Desktop for Windows?** Check out the [Docker Knowledge
Hub](http://success.docker.com/q) for knowledge base articles, FAQs, and
technical support for various subscription levels.
@@ -22,7 +22,7 @@ technical support for various subscription levels.
### In-app diagnostics
If you encounter problems for which you do not find solutions in this
documentation, on [Docker for Windows issues on
documentation, on [Docker Desktop for Windows issues on
GitHub](https://github.com/docker/for-win/issues), or the [Docker for Win
forum](https://forums.docker.com/c/docker-for-windows), we can help you
troubleshoot the log data.
@@ -41,7 +41,7 @@ Desktop](https://docs.docker.com/docker-for-mac/faqs/#how-is-personal-data-handl
![Diagnose & Feedback with ID](images/diagnostic-id.png){:width="600px"}
If you click on **Report an issue**, this opens [Docker for Windows issues on
If you click on **Report an issue**, this opens [Docker Desktop for Windows issues on
GitHub](https://github.com/docker/for-win/issues/) in your web browser in a
"create new issue" template, to be completed before submision. Do not forget to
include your diagnostic ID.
@@ -51,7 +51,7 @@ include your diagnostic ID.
### Diagnosing from the terminal
On occasions it is useful to run the diagnostics yourself, for instance if
Docker for Windows cannot start.
Docker Desktop for Windows cannot start.
First locate the `com.docker.diagnose`, that should be in `C:\Program
Files\Docker\Docker\resources\com.docker.diagnose.exe`.
@@ -74,7 +74,7 @@ Diagnostics ID: CD6CF862-9CBD-4007-9C2F-5FBE0572BBC2/20180720152545 (uploade
### Make sure certificates are set up correctly
Docker for Windows ignores certificates listed under insecure registries, and
Docker Desktop for Windows ignores certificates listed under insecure registries, and
does not send client certificates to them. Commands like `docker run` that
attempt to pull from the registry produces error messages on the command line,
like this:
@@ -99,7 +99,7 @@ Getting Started topic.
#### Permissions errors on data directories for shared volumes
Docker for Windows sets permissions on [shared volumes](index.md#shared-drives)
Docker Desktop for Windows sets permissions on [shared volumes](index.md#shared-drives)
to a default value of [0777](http://permissions-calculator.org/decode/0777/)
(`read`, `write`, `execute` permissions for `user` and for `group`).
@@ -109,7 +109,7 @@ volume defaults at container runtime, you need to either use non-host-mounted
volumes or find a way to make the applications work with the default file
permissions.
Docker for Windows currrently implements host-mounted volumes based on the
Docker Desktop for Windows currrently implements host-mounted volumes based on the
[Microsoft SMB
protocol](https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx),
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).
#### inotify on shared drives does not work
Currently, `inotify` does not work on Docker for Windows. This becomes evident,
Currently, `inotify` does not work on Docker Desktop for Windows. This becomes evident,
for example, when an application needs to read/write to a container across a
mounted drive. Instead of relying on filesystem inotify, we recommend using
polling features for your framework or programming language.
@@ -133,7 +133,7 @@ polling features for your framework or programming language.
polling mode described here: [nodemon isn't restarting node
applications](https://github.com/remy/nodemon#application-isnt-restarting)
* **Docker for Windows issue on GitHub** - See the issue [Inotify on shared
* **Docker Desktop for Windows issue on GitHub** - See the issue [Inotify on shared
drives does not
work](https://github.com/docker/for-win/issues/56#issuecomment-242135705)
@@ -214,7 +214,7 @@ container](https://github.com/docker/for-win/issues/25).
#### Volume mounts from host paths use a `nobrl` option to override database locking
You may encounter problems using volume mounts on the host, depending on the
database software and which options are enabled. Docker for Windows uses
database software and which options are enabled. Docker Desktop for Windows uses
[SMB/CIFS
protocols](https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx)
to mount host paths, and mounts them with the `nobrl` option, which prevents
@@ -239,7 +239,7 @@ Compose file documentation.
#### Local security policies can block shared drives and cause login errors
You need permissions to mount shared drives to use the Docker for Windows
You need permissions to mount shared drives to use the Docker Desktop for Windows
[shared drives](index.md#shared-drives) feature.
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).
### Virtualization
In order for Docker for Windows to function properly your machine needs:
In order for Docker Desktop for Windows to function properly your machine needs:
1. [Hyper-V](https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-technology-overview)
installed and working
@@ -297,14 +297,14 @@ In order for Docker for Windows to function properly your machine needs:
#### Hyper-V
Docker for Windows requires a Hyper-V as well as the Hyper-V Module for Windows
Powershell to be installed and enabled. The Docker for Windows installer enables
Docker Desktop for Windows requires a Hyper-V as well as the Hyper-V Module for Windows
Powershell to be installed and enabled. The Docker Desktop for Windows installer enables
it for you.
See [these
instructions](https://msdn.microsoft.com/en-us/virtualization/hyperv_on_windows/quick_start/walkthrough_install)
to install Hyper-V manually. A reboot is *required*. If you install Hyper-V
without the reboot, Docker for Windows does not work correctly. On some systems,
without the reboot, Docker Desktop for Windows does not work correctly. On some systems,
Virtualization needs to be enabled in the BIOS. The steps to do so are Vendor
specific, but typically the BIOS option is called `Virtualization Technology
(VTx)` or similar.
@@ -317,11 +317,11 @@ In the subequent screen, verify Hyper-V is enabled and has a checkmark:
#### Hyper-V driver for Docker Machine
Docker for Windows comes with the legacy tool Docker Machine which uses the old
Docker Desktop for Windows comes with the legacy tool Docker Machine which uses the old
[`boot2docker.iso`](https://github.com/boot2docker/boot2docker){:
target="_blank" class="_"}, and the [Microsoft Hyper-V
driver](/machine/drivers/hyper-v.md) to create local virtual machines. _This is
tangential to using Docker for Windows_, but if you want to use Docker Machine
tangential to using Docker Desktop for Windows_, but if you want to use Docker Machine
to create multiple local VMs, or to provision remote machines, see the [Docker
Machine](/machine/index.md) topics. We mention this here only in case someone is
looking for information about Docker Machine on Windows, which requires that
@@ -337,16 +337,16 @@ Performance tab on the Task Manager:
![Task Manager](images/virtualization-enabled.png){:width="700px"}
If, at some point, if you manually uninstall Hyper-V or disable virtualization,
Docker for Windows cannot start. See: [Unable to run Docker for Windows on
Docker Desktop for Windows cannot start. See: [Unable to run Docker for Windows on
Windows 10 Enterprise](https://github.com/docker/for-win/issues/74).
### Networking and WiFi problems upon Docker for Windows install
### Networking and WiFi problems upon Docker Desktop for Windows install
Some users have encountered networking issues during install and startup of
Docker for Windows. For example, upon install or auto-reboot, network adapters
Docker Desktop for Windows. For example, upon install or auto-reboot, network adapters
and/or WiFi gets disabled. In some scenarios, problems are due to having
VirtualBox or its network adapters still installed, but in other scenarios this
is not the case. (See also, Docker for Windows issue on GitHub: [Enabling
is not the case. (See also, Docker Desktop for Windows issue on GitHub: [Enabling
Hyper-V feature turns my wi-fi
off](https://github.com/docker/for-win/issues/139).)
@@ -392,7 +392,7 @@ A full tutorial is available in [docker/labs](https://github.com/docker/labs) at
Containers](https://github.com/docker/labs/blob/master/windows/windows-containers/README.md).
You can install a native Windows binary which allows you to develop and run
Windows containers without Docker for Windows. However, if you install Docker
Windows containers without Docker Desktop for Windows. However, if you install Docker
this way, you cannot develop or run Linux containers. If you try to run a Linux
container on the native Docker daemon, an error occurs:
@@ -404,7 +404,7 @@ C:\Program Files\Docker\docker.exe:
### Limitations of Windows containers for `localhost` and published ports
Docker for Windows provides the option to switch Windows and Linux containers.
Docker Desktop for Windows provides the option to switch Windows and Linux containers.
If you are using Windows containers, keep in mind that there are some
limitations with regard to networking due to the current implementation of
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
For more information, see:
* Docker for Windows issue on GitHub: [Port binding does not work for
* Docker Desktop for Windows issue on GitHub: [Port binding does not work for
locahost](https://github.com/docker/for-win/issues/458)
* [Published Ports on Windows Containers Don't Do
@@ -469,16 +469,16 @@ For more information, see:
limitations](https://blogs.technet.microsoft.com/virtualization/2016/05/25/windows-nat-winnat-capabilities-and-limitations/)
### Running Docker for Windows in nested virtualization scenarios
### Running Docker Desktop for Windows in nested virtualization scenarios
Docker for Windows can run inside a Windows 10 virtual machine (VM) running on
Docker Desktop for Windows can run inside a Windows 10 virtual machine (VM) running on
apps like Parallels or VMware Fusion on a Mac provided that the VM is properly
configured. However, problems and intermittent failures may still occur due to
the way these apps virtualize the hardware. For these reasons, _**Docker for
Windows is not supported for nested virtualization scenarios**_. It might work
in some cases, and not in others.
The better solution is to run Docker for Windows natively on a Windows system
The better solution is to run Docker Desktop for Windows natively on a Windows system
(to work with Windows or Linux containers), or Docker for Mac on Mac to work
with Linux containers.
@@ -548,14 +548,14 @@ We are currently investigating this issue.
### NAT/IP configuration
By default, Docker for Windows uses an internal network prefix of
By default, Docker Desktop for Windows uses an internal network prefix of
`10.0.75.0/24`. Should this clash with your normal network setup, you can change
the prefix from the **Settings** menu. See the [Network](index.md#network) topic
under [Settings](index.md#docker-settings).
## Workarounds
### `inotify` currently does not work on Docker for Windows
### `inotify` currently does not work on Docker Desktop for Windows
If you are using `Node.js` with `nodemon`, a temporary workaround is to try the
fallback polling mode described here: [nodemon isn't restarting node
@@ -576,10 +576,10 @@ consult the shell's documentation.
### Make sure Docker is running for webserver examples
For the `hello-world-nginx` example and others, Docker for Windows must be
For the `hello-world-nginx` example and others, Docker Desktop for Windows must be
running to get to the webserver on `http://localhost/`. Make sure that the
Docker whale is showing in the menu bar, and that you run the Docker commands in
a shell that is connected to the Docker for Windows Engine (not Engine from
a shell that is connected to the Docker Desktop for Windows Engine (not Engine from
Toolbox). Otherwise, you might start the webserver container but get a "web page
not available" error when you go to `docker`.
@@ -601,7 +601,7 @@ docker app.
**Some firewalls and anti-virus software might be incompatible with Microsoft
**Windows 10 builds**, such as Windows 10 Anniversary Update. The conflict
typically occurs after a Windows update or new install of the firewall, and
manifests as an error response from the Docker daemon and a **Docker for Windows
manifests as an error response from the Docker daemon and a **Docker Desktop for Windows
start failure**. The Comodo Firewall was one example of this problem, but users
report that software has since been updated to work with these Windows 10
builds.
@@ -610,7 +610,7 @@ See the Comodo forums topics [Comodo Firewall conflict with
Hyper-V](https://forums.comodo.com/bug-reports-cis/comodo-firewall-began-conflict-with-hyperv-t116351.0.html)
and [Windows 10 Anniversary build doesn't allow Comodo drivers to be
installed](https://forums.comodo.com/install-setup-configuration-help-cis/windows-10-aniversary-build-doesnt-allow-comodo-drivers-to-be-installed-t116322.0.html).
A Docker for Windows user-created issue describes the problem specifically as it
A Docker Desktop for Windows user-created issue describes the problem specifically as it
relates to Docker: [Docker fails to start on Windows
10](https://github.com/docker/for-win/issues/27).