docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Repair D4W links (#6508)

This commit is contained in:
Gwendolynne Barr 2018-04-21 08:09:44 -07:00 committed by GitHub
parent 1c752a8c0b
commit ca11ab6577
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 59 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

117
docker-for-windows/faqs.md
View File

@ -4,17 +4,16 @@ keywords: windows faqs
title: Frequently asked questions (FAQ) title: Frequently asked questions (FAQ)
--- ---
>**Looking for popular FAQs on Docker for Windows?** **Looking for popular FAQs on Docker for Windows?** Check out the
>Check out the [Docker [Docker Success Center](http://success.docker.com/){: target="_blank" class="_"}
Knowledge Hub](http://success.docker.com/) for knowledge base articles, FAQs, for knowledge base articles, FAQs, technical support for subscription levels, and more.
technical support for various subscription levels, and more.
### Questions about Stable and Edge channels ### Questions about Stable and Edge channels
#### How do I get the Stable or Edge version of Docker for Windows? #### How do I get the Stable or Edge version of Docker for Windows?
Use the download links for the channels given in the topic [Download Docker for Use the download links for the channels given in the topic
Windows](install.md#download-docker-for-windows). [Download Docker for Windows](install#download-docker-for-windows).
This topic also has more information about the two channels. This topic also has more information about the two channels.
@ -58,11 +57,11 @@ below.</font><br>
Do the following each time: Do the following each time:
1. Use `docker save` to save any images you want to keep. (See 1. Use `docker save` to save any images you want to keep. (See
[save](/engine/reference/commandline/save.md) in the Docker Engine command [save](/engine/reference/commandline/save) in the Docker Engine command
line reference.) line reference.)
2. Use `docker export` to export containers you want to keep. (See 2. Use `docker export` to export containers you want to keep. (See
[export](/engine/reference/commandline/export.md) in the Docker Engine command [export](/engine/reference/commandline/export) in the Docker Engine command
line reference.) line reference.)
3. Uninstall the current app (whether Stable or Edge). 3. Uninstall the current app (whether Stable or Edge).
@ -79,21 +78,21 @@ command line integration, and so on. Tell us about problems, what you like, or
functionality you'd like to see added. functionality you'd like to see added.
We are especially interested in getting feedback on the new swarm mode described We are especially interested in getting feedback on the new swarm mode described
in [Docker Swarm](/engine/swarm/index.md). A good place to start is the in [Docker Swarm](/engine/swarm/). A good place to start is the
[tutorial](/engine/swarm/swarm-tutorial/index.md). [tutorial](/engine/swarm/swarm-tutorial/).
#### What if I have problems or questions? #### What if I have problems or questions?
You can find the list of frequent issues in You can find the list of frequent issues in
[Logs and Troubleshooting](troubleshoot.md). [Logs and Troubleshooting](troubleshoot).
If you do not find a solution in Troubleshooting, browse issues on [Docker for If you do not find a solution in Troubleshooting, browse issues on
Windows issues on GitHub](https://github.com/docker/for-win/issues) or create a [Docker for Windows issues on GitHub](https://github.com/docker/for-win/issues){: target="_blank" class="_"}
new one. You can also create new issues based on diagnostics. To learn more or create a new one. You can also create new issues based on diagnostics. To
about running diagnostics and about Docker for Windows GitHub issues, see learn more about running diagnostics and about Docker for Windows GitHub issues,
[Diagnose and Feedback](index.md#diagnose-and-feedback). see [Diagnose and Feedback](/docker-for-windows#diagnose--feedback).
[Docker for Windows forum](https://forums.docker.com/c/docker-for-windows) [Docker for Windows forum](https://forums.docker.com/c/docker-for-windows){: target="_blank" class="_"}
provides discussion threads as well, and you can create discussion topics there, provides discussion threads as well, and you can create discussion topics there,
but we recommend using the GitHub issues over the forums for better tracking and but we recommend using the GitHub issues over the forums for better tracking and
response. response.
@ -105,47 +104,48 @@ information, see [Stable and Edge channels](#questions-about-stable-and-edge-cha
### Can I use Docker for Windows with new swarm mode? ### Can I use Docker for Windows with new swarm mode?
Yes! You can use Docker for Windows to test single-node features of [swarm Yes! You can use Docker for Windows to test single-node features of
mode](/engine/swarm/index.md) introduced with Docker Engine 1.12, including [swarm mode](/engine/swarm/) introduced with Docker Engine 1.12, including
initializing a swarm with a single node, creating services, and scaling initializing a swarm with a single node, creating services, and scaling
services. Docker “Moby” on Hyper-V serves as the single swarm node. You can also services. Docker “Moby” on Hyper-V serves as the single swarm node. You can also
use Docker Machine, which comes with Docker for Windows, to create and use Docker Machine, which comes with Docker for Windows, to create and
experiment with a multi-node swarm. Check out the tutorial at [Get started with experiment with a multi-node swarm. Check out the tutorial at
swarm mode](/engine/swarm/swarm-tutorial/index.md). [Get started with swarm mode](/engine/swarm/swarm-tutorial/).
### How do I connect to the remote Docker Engine API? ### How do I connect to the remote Docker Engine API?
You might need to provide the location of the Engine API for Docker clients and development tools. You might need to provide the location of the Engine API for Docker clients and development tools.
On Docker for Windows, clients can connect to the Docker Engine through a **named pipe**: `npipe:////./pipe/docker_engine`, or **TCP socket** at this URL: `tcp://localhost:2375`. On Docker for Windows, clients can connect to the Docker Engine through a
**named pipe**: `npipe:////./pipe/docker_engine`, or **TCP socket** at this URL:
`tcp://localhost:2375`.
This sets `DOCKER_HOST` and `DOCKER_CERT_PATH` environment variables to the given values (for the named pipe or TCP socket, whichever you use). This sets `DOCKER_HOST` and `DOCKER_CERT_PATH` environment variables to the
given values (for the named pipe or TCP socket, whichever you use).
See also [Docker Engine API](/engine/api.md) and the Docker for Windows forums See also [Docker Engine API](/engine/api) and the Docker for Windows forums
topic topic
[How to find the remote API](https://forums.docker.com/t/how-to-find-the-remote-api/20988). [How to find the remote API](https://forums.docker.com/t/how-to-find-the-remote-api/20988){: target="_blank" class="_"}.
### Volumes ### Volumes
#### Can I change permissions on shared volumes for container-specific deployment requirements? #### Can I change permissions on shared volumes for container-specific deployment requirements?
No, at this point, Docker for Windows does not enable you to control (`chmod`) No, at this point, Docker for Windows does not enable you to control (`chmod`)
the Unix-style permissions on [shared the Unix-style permissions on [shared volumes](/docker-for-windows#shared-drives) for
volumes](index.md#shared-drives) for deployed containers, deployed containers, but rather sets permissions to a default value of
but rather sets permissions to a default value of [0755](http://permissions-calculator.org/decode/0755/){: target="_blank" class="_"}
[0755](http://permissions-calculator.org/decode/0755/) (`read`, `write`, (`read`, `write`, `execute` permissions for `user`, `read` and `execute` for
`execute` permissions for `user`, `read` and `execute` for `group`) which is not `group`) which is not configurable.
configurable.
For workarounds and to learn more, see [Permissions errors on data directories For workarounds and to learn more, see
for shared [Permissions errors on data directories for shared volumes](troubleshoot#permissions-errors-on-data-directories-for-shared-volumes).
volumes](troubleshoot.md#permissions-errors-on-data-directories-for-shared-volumes).
#### Why doesn't `nodemon` pick up file changes in a container mounted on a shared drive? #### Why doesn't `nodemon` pick up file changes in a container mounted on a shared drive?
Currently, `inotify` does not work on Docker for Windows. This is a known issue. Currently, `inotify` does not work on Docker for Windows. This is a known issue.
For more information and a temporary workaround, see [inotify on shared drives For more information and a temporary workaround, see
does not work](troubleshoot.md#inotify-on-shared-drives-does-not-work) in [inotify on shared drives does not work](troubleshoot#inotify-on-shared-drives-does-not-work){: target="_blank" class="_"}
[Troubleshooting](troubleshoot.md). in [Troubleshooting](troubleshoot).
#### Are symlinks supported? #### Are symlinks supported?
@ -156,10 +156,10 @@ Symlinks created outside of Docker do not work.
To learn more about the reasons for this limitation, see the following discussions: To learn more about the reasons for this limitation, see the following discussions:
* GitHub issue: * GitHub issue:
[Symlinks don't work as expected](https://github.com/docker/for-win/issues/109#issuecomment-251307391) [Symlinks don't work as expected](https://github.com/docker/for-win/issues/109#issuecomment-251307391){: target="_blank" class="_"}
* Docker for Windows forums topic: * Docker for Windows forums topic:
[Symlinks on shared volumes not supported](https://forums.docker.com/t/symlinks-on-shared-volumes-not-supported/9288) [Symlinks on shared volumes not supported](https://forums.docker.com/t/symlinks-on-shared-volumes-not-supported/9288){: target="_blank" class="_"}
### Certificates ### Certificates
@ -177,7 +177,7 @@ if an enterprise SSL certificate is trusted by the user on the host, it is
trusted by Docker for Windows. trusted by Docker for Windows.
To learn more about how to install a CA root certificate for the registry, see To learn more about how to install a CA root certificate for the registry, see
[Verify repository client with certificates](/engine/security/certificates.md) [Verify repository client with certificates](/engine/security/certificates)
in the Docker Engine topics. in the Docker Engine topics.
#### How do I add client certificates? #### How do I add client certificates?
@ -194,14 +194,14 @@ directory on Moby (the Docker for Windows virtual machine running on Hyper-V).
You need to restart Docker for Windows after making any changes to the keychain You need to restart Docker for Windows after making any changes to the keychain
or to the `~/.docker/certs.d` directory in order for the changes to take effect. or to the `~/.docker/certs.d` directory in order for the changes to take effect.
The registry cannot be listed as an _insecure registry_ (see [Docker The registry cannot be listed as an _insecure registry_ (see
Daemon](index.md#docker-daemon)). Docker for Windows ignores [Docker Daemon](/docker-for-windows#daemon)). Docker for Windows ignores
certificates listed under insecure registries, and does not send client certificates listed under insecure registries, and does not send client
certificates. Commands like `docker run` that attempt to pull from the registry certificates. Commands like `docker run` that attempt to pull from the registry
produce error messages on the command line, as well as on the registry. produce error messages on the command line, as well as on the registry.
To learn more about how to set the client TLS certificate for verification, see To learn more about how to set the client TLS certificate for verification, see
[Verify repository client with certificates](/engine/security/certificates.md) [Verify repository client with certificates](/engine/security/certificates)
in the Docker Engine topics. in the Docker Engine topics.
### Why does Docker for Windows sometimes lose network connectivity, causing `push` or `pull` commands to fail? ### Why does Docker for Windows sometimes lose network connectivity, causing `push` or `pull` commands to fail?
@ -222,25 +222,23 @@ Docker for Windows does not support mounts for nodes you created with
`docker-machine`. `docker-machine`.
For more about sharing local drives with containers using Docker for Windows, For more about sharing local drives with containers using Docker for Windows,
see [Shared Drives](index.md#shared-drives) in the Getting see [Shared drives](/docker-for-windows#shared-drives) in the Getting
Started topic. Started topic.
To learn more about using Docker for Windows and Docker Machine, see [What to To learn more about using Docker for Windows and Docker Machine, see
know before you install](install.md#what-to-know-before-you-install) in the [What to know before you install](install#what-to-know-before-you-install) in the
Getting Started topic. For more about Docker Machine itself, see [What is Docker Getting Started topic. For more about Docker Machine itself, see
Machine?](/machine/overview.md#what-is-docker-machine), and the [Hyper-V [What is Docker Machine?](/machine/overview#what-is-docker-machine), and the
driver](/machine/drivers/hyper-v.md) for Docker Machine. [Hyper-V driver](/machine/drivers/hyper-v) for Docker Machine.
### Windows Requirements ### Windows Requirements
#### How do I run Windows containers on Docker on Windows Server 2016? #### How do I run Windows containers on Docker on Windows Server 2016?
See [About Windows containers and Windows Server See [About Windows containers and Windows Server 2016](/install/windows/docker-ee/#about-docker-ee-containers-and-windows-server).
2016](index.md#about-windows-containers-and-windows-server-2016).
A full tutorial is available in [docker/labs](https://github.com/docker/labs) at A full tutorial is available in [docker/labs](https://github.com/docker/labs){: target="_blank" class="_"} at
[Getting Started with Windows [Getting Started with Windows Containers](https://github.com/docker/labs/blob/master/windows/windows-containers/README.md){: target="_blank" class="_"}.
Containers](https://github.com/docker/labs/blob/master/windows/windows-containers/README.md).
#### Why is Windows 10 Home not supported? #### Why is Windows 10 Home not supported?
@ -257,15 +255,14 @@ Windows to work.
Some firewalls and anti-virus software might be incompatible with Hyper-V and Some firewalls and anti-virus software might be incompatible with Hyper-V and
some Windows 10 builds (possibly, the Anniversary Update), which impacts Docker some Windows 10 builds (possibly, the Anniversary Update), which impacts Docker
for Windows. See details and workarounds in [Docker fails to start when firewall for Windows. See details and workarounds in
or anti-virus software is [Docker fails to start when firewall or anti-virus software is installed](troubleshoot#docker-fails-to-start-when-firewall-or-anti-virus-software-is-installed)
installed](troubleshoot.md#docker-fails-to-start-when-firewall-or-anti-virus-software-is-installed) in [Troubleshooting](troubleshoot).
in [Troubleshooting](troubleshoot.md).
### How do I uninstall Docker Toolbox? ### How do I uninstall Docker Toolbox?
You might decide that you do not need Toolbox now that you have Docker for You might decide that you do not need Toolbox now that you have Docker for
Windows, and want to uninstall it. For details on how to perform a clean Windows, and want to uninstall it. For details on how to perform a clean
uninstall of Toolbox on Windows, see [How to uninstall uninstall of Toolbox on Windows, see
Toolbox](/toolbox/toolbox_install_windows.md#how-to-uninstall-toolbox) in the [How to uninstall Toolbox](/toolbox/toolbox_install_windows#how-to-uninstall-toolbox) in the
Toolbox Windows topics. Toolbox Windows topics.

4
docker-for-windows/index.md
View File

@ -212,12 +212,12 @@ crash reports, and usage data. This information helps Docker improve and
troubleshoot the application. Uncheck to opt out. Docker may also sometimes troubleshoot the application. Uncheck to opt out. Docker may also sometimes
prompt you for more information. prompt you for more information.
### Shared Drives ### Shared drives
Share your local drives (volumes) with Docker for Windows, so that they are Share your local drives (volumes) with Docker for Windows, so that they are
available to your [Linux containers](#switch-between-windows-and-linux-containers). available to your [Linux containers](#switch-between-windows-and-linux-containers).
![Shared Drives](images/settings-shared-drives.png){:width="600px"} ![Shared drives](images/settings-shared-drives.png){:width="600px"}
Permission for shared drives are tied to the credentials you provide here. If Permission for shared drives are tied to the credentials you provide here. If
you run `docker` commands under a different username than the one configured you run `docker` commands under a different username than the one configured