mirror of https://github.com/docker/docs.git
desktop: use relative markdown links
Unfortunately, the only reliable way to create internal links is to use relative links to other Markdown files. This does match the way links on GitHub work, but makes it harder to create these links. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn
parent
9cd60d843e
commit
087e391397
|
|
@ -16,9 +16,9 @@ The Docker Desktop Dashboard offers the following benefits:
|
|||
|
||||
In addition, the Dashboard UI allows you to:
|
||||
|
||||
- Navigate to the [Settings](/docker-for-mac/index/#preferences) menu to configure Docker Desktop preferences
|
||||
- Navigate to the [Settings](index.md#preferences) menu to configure Docker Desktop preferences
|
||||
- Access the [Troubleshoot](troubleshoot.md) menu to debug and perform restart operations
|
||||
- Sign into [Docker Hub](/docker-for-mac/index/#docker-hub) using your Docker ID
|
||||
- Sign into [Docker Hub](index.md#docker-hub) using your Docker ID
|
||||
|
||||
To access the Docker Desktop Dashboard, from the Docker menu, select **Dashboard**. The Dashboard provides a runtime view of all your containers and applications.
|
||||
|
||||
|
|
|
|||
|
|
@ -103,7 +103,7 @@ continue to use Docker Machine, which operates outside the scope of Docker Deskt
|
|||
> `/usr/local/bin` with symlinks to its own versions.
|
||||
{:.warning}
|
||||
|
||||
See also [Unset environment variables in the current shell](/machine/get-started.md#unset-environment-variables-in-the-current-shell)
|
||||
See also [Unset environment variables in the current shell](../machine/get-started.md#unset-environment-variables-in-the-current-shell)
|
||||
in the Docker Machine topics.
|
||||
|
||||
## Docker Toolbox and Docker Desktop coexistence
|
||||
|
|
@ -221,5 +221,5 @@ it](https://docs.docker.com/toolbox/toolbox_install_mac/#how-to-uninstall-toolbo
|
|||
|
||||
You might decide that you do not need Toolbox now that you have Docker Desktop,
|
||||
and want to uninstall it. For details on how to perform a clean uninstall of
|
||||
Toolbox on Mac, see [How to uninstall Toolbox](/toolbox/toolbox_install_mac.md#how-to-uninstall-toolbox)
|
||||
Toolbox on Mac, see [How to uninstall Toolbox](../toolbox/toolbox_install_mac.md#how-to-uninstall-toolbox)
|
||||
in the Toolbox Mac topics.
|
||||
|
|
|
|||
|
|
@ -664,7 +664,7 @@ This release contains a Kubernetes upgrade. Note that your local Kubernetes clus
|
|||
- [Docker 17.12.0-ce](https://github.com/docker/docker-ce/releases/tag/v17.12.0-ce)
|
||||
|
||||
* New
|
||||
- Experimental Kubernetes Support. You can now run a single-node Kubernetes cluster from the "Kubernetes" Pane in Docker For Mac Preferences and use kubectl commands as well as docker commands. See https://docs.docker.com/docker-for-mac/kubernetes/
|
||||
- Experimental Kubernetes Support. You can now run a single-node Kubernetes cluster from the "Kubernetes" Pane in Docker For Mac Preferences and use kubectl commands as well as docker commands. See [https://docs.docker.com/docker-for-mac/kubernetes/](kubernetes.md)
|
||||
- DNS name `docker.for.mac.host.internal` should be used instead of `docker.for.mac.localhost` (still valid) for host resolution from containers, since since there is an RFC banning the use of subdomains of localhost (See https://tools.ietf.org/html/draft-west-let-localhost-be-localhost-06).
|
||||
|
||||
* Bug fixes and minor changes
|
||||
|
|
@ -871,7 +871,7 @@ TCP connection is idle for more than five minutes (related to
|
|||
|
||||
- Add daemon options validation
|
||||
- Diagnose can be cancelled & Improved help information. Fixes [docker/for-mac#1134](https://github.com/docker/for-mac/issues/1134), [docker/for-mac#1474](https://github.com/docker/for-mac/issues/1474)
|
||||
- Support paging of Docker Cloud [repositories](/docker-cloud/builds/repos.md) and [organizations](/docker-cloud/orgs.md). Fixes [docker/for-mac#1538](https://github.com/docker/for-mac/issues/1538)
|
||||
- Support paging of Docker Cloud [repositories](../docker-hub/repos.md) and [organizations](../docker-hub/orgs.md). Fixes [docker/for-mac#1538](https://github.com/docker/for-mac/issues/1538)
|
||||
|
||||
### Docker Community Edition 17.06.1-ce-mac20, 2017-07-18
|
||||
|
||||
|
|
@ -1724,7 +1724,7 @@ events or unexpected unmounts.
|
|||
|
||||
**Bug fixes and minor changes**
|
||||
|
||||
* Documentation moved to [https://docs.docker.com/docker-for-mac/](/docker-for-mac/)
|
||||
* Documentation moved to [https://docs.docker.com/docker-for-mac/](index.md)
|
||||
* Allow non-admin users to launch the app for the first time (using admin creds)
|
||||
* Prompt non-admin users for admin password when needed in Preferences
|
||||
* Fixed download links, documentation links
|
||||
|
|
|
|||
|
|
@ -25,7 +25,7 @@ The **Edge channel** provides an installer with new features we are working on,
|
|||
|
||||
### Can I switch between Stable and Edge versions of Docker Desktop?
|
||||
|
||||
Yes, you can switch between Stable and Edge versions. You can try out the Edge releases to see what's new, then go back to Stable for other work. However, **you can only have one version of Docker Desktop installed at a time**. For more information, see [Switch between Stable and Edge versions](/docker-for-mac/install/#switch-between-stable-and-edge-versions).
|
||||
Yes, you can switch between Stable and Edge versions. You can try out the Edge releases to see what's new, then go back to Stable for other work. However, **you can only have one version of Docker Desktop installed at a time**. For more information, see [Switch between Stable and Edge versions](install.md#switch-between-stable-and-edge-versions).
|
||||
|
||||
### What is Docker.app?
|
||||
|
||||
|
|
@ -49,7 +49,7 @@ development tools.
|
|||
On Docker Desktop, clients can connect to the Docker Engine through a Unix
|
||||
socket: `unix:///var/run/docker.sock`.
|
||||
|
||||
See also [Docker Engine API](/engine/api.md) and Docker Desktop for Mac forums topic
|
||||
See also [Docker Engine API](../engine/api/index.md) and Docker Desktop for Mac forums topic
|
||||
[Using pycharm Docker plugin..](https://forums.docker.com/t/using-pycharm-docker-plugin-with-docker-beta/8617){: target="_blank" class="_"}.
|
||||
|
||||
If you are working with applications like [Apache Maven](https://maven.apache.org/){: target="_blank" class="_"}
|
||||
|
|
@ -67,7 +67,7 @@ Mac has a changing IP address (or none if you have no network access). We recomm
|
|||
Mac so that containers can connect to this address.
|
||||
|
||||
For more information and examples, see
|
||||
[I want to connect from a container to a service on the host](networking.md#i-want-to-connect-from-a-container-to-a-service-on-the-host) in the [Networking](/docker-for-mac/networking/) topic.
|
||||
[I want to connect from a container to a service on the host](networking.md#i-want-to-connect-from-a-container-to-a-service-on-the-host) in the [Networking](networking.md) topic.
|
||||
|
||||
### How do I connect to a container from Mac?
|
||||
|
||||
|
|
@ -78,17 +78,17 @@ For more information and examples, see
|
|||
|
||||
### Can I use an SSH agent inside a container?
|
||||
|
||||
Yes, you can use the host’s SSH agent inside a container. For more information, see [SSH agent forwarding](/docker-for-mac/osxfs/#ssh-agent-forwarding).
|
||||
Yes, you can use the host’s SSH agent inside a container. For more information, see [SSH agent forwarding](osxfs.md#ssh-agent-forwarding).
|
||||
|
||||
### How do I add custom CA certificates?
|
||||
|
||||
Docker Desktop supports all trusted certificate authorities (CAs) (root or intermediate). For more information on adding server and client side certs, see
|
||||
[Add TLS certificates](/docker-for-mac/#add-tls-certificates) in the Getting Started topic.
|
||||
[Add TLS certificates](index.md#add-tls-certificates) in the Getting Started topic.
|
||||
|
||||
### How do I add client certificates?
|
||||
|
||||
For information on adding client certificates, see
|
||||
[Add client certificates](/docker-for-mac/index/#adding-client-certificates) in the Getting Started topic.
|
||||
[Add client certificates](index.md#add-client-certificates) in the Getting Started topic.
|
||||
|
||||
### Can I pass through a USB device to a container?
|
||||
|
||||
|
|
|
|||
|
|
@ -205,7 +205,7 @@ You can configure Docker Desktop networking to work on a virtual private network
|
|||
The Docker Engine page allows you to configure the Docker daemon to determine how your containers run.
|
||||
|
||||
Type a JSON configuration file in the box to configure the daemon settings. For a full list of options, see the Docker Engine
|
||||
[dockerd commandline reference](/engine/reference/commandline/dockerd.md){:target="_blank"
|
||||
[dockerd commandline reference](/engine/reference/commandline/dockerd/){:target="_blank"
|
||||
class="_"}.
|
||||
|
||||
Click **Apply & Restart** to save your settings and restart Docker Desktop.
|
||||
|
|
@ -274,7 +274,7 @@ experience conflicts, remove `/usr/local/bin/kubectl`.
|
|||
|
||||
- To enable Kubernetes support and install a standalone instance of Kubernetes
|
||||
running as a Docker container, select **Enable Kubernetes**. To set Kubernetes as the
|
||||
[default orchestrator](/docker-for-mac/kubernetes/#override-the-default-orchestrator), select **Deploy Docker Stacks to Kubernetes by default**.
|
||||
[default orchestrator](kubernetes.md#override-the-default-orchestrator), select **Deploy Docker Stacks to Kubernetes by default**.
|
||||
|
||||
Click **Apply & Restart** to save the settings. This instantiates images required to run the Kubernetes server as containers, and installs the
|
||||
`/usr/local/bin/kubectl` command on your Mac.
|
||||
|
|
@ -411,7 +411,7 @@ also in your keychain.
|
|||
|
||||
To learn more about how to install a CA root certificate for the registry and
|
||||
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.md)
|
||||
in the Docker Engine topics.
|
||||
|
||||
## Install shell completion
|
||||
|
|
@ -479,11 +479,11 @@ For information about providing feedback on the documentation or update it yours
|
|||
|
||||
Select **Sign in /Create Docker ID** from the Docker Desktop menu to access your [Docker Hub](https://hub.docker.com/){: target="_blank" class="_" } account. Once logged in, you can access your Docker Hub repositories and organizations directly from the Docker Desktop menu.
|
||||
|
||||
For more information, refer to the following [Docker Hub topics](/docker-hub/index.md){:target="_blank"
|
||||
For more information, refer to the following [Docker Hub topics](../docker-hub/index.md){:target="_blank"
|
||||
class="_"}:
|
||||
|
||||
* [Organizations and Teams in Docker Hub](/docker-hub/orgs.md){:target="_blank" class="_"}
|
||||
* [Builds](/docker-hub/builds/index.md){:target="_blank" class="_"}
|
||||
* [Organizations and Teams in Docker Hub](../docker-hub/orgs.md){:target="_blank" class="_"}
|
||||
* [Builds](../docker-hub/builds/index.md){:target="_blank" class="_"}
|
||||
|
||||
### Two-factor authentication
|
||||
|
||||
|
|
@ -512,7 +512,7 @@ After you have successfully authenticated, you can access your organizations and
|
|||
walkthroughs and source code.
|
||||
|
||||
* For a summary of Docker command line interface (CLI) commands, see
|
||||
[Docker CLI Reference Guide](/engine/api/index.md){: target="_blank" class="_"}.
|
||||
[Docker CLI Reference Guide](../engine/api/index.md){: target="_blank" class="_"}.
|
||||
|
||||
* Check out the blog post, [What’s New in Docker 17.06 Community Edition
|
||||
(CE)](https://blog.docker.com/2017/07/whats-new-docker-17-06-community-edition-ce/){:
|
||||
|
|
|
|||
|
|
@ -48,8 +48,8 @@ Your Mac must meet the following requirements to successfully install Docker Des
|
|||
## What's included in the installer
|
||||
|
||||
The Docker Desktop installation includes
|
||||
[Docker Engine](/engine/index.md), Docker CLI client,
|
||||
[Docker Compose](/compose/index.md), [Notary](/notary/getting_started/), [Kubernetes](https://github.com/kubernetes/kubernetes/), and [Credential Helper](https://github.com/docker/docker-credential-helpers/).
|
||||
[Docker Engine](../engine/index.md), Docker CLI client,
|
||||
[Docker Compose](../compose/index.md), [Notary](../notary/getting_started.md), [Kubernetes](https://github.com/kubernetes/kubernetes/), and [Credential Helper](https://github.com/docker/docker-credential-helpers/).
|
||||
|
||||
## Install and run Docker Desktop on Mac
|
||||
|
||||
|
|
|
|||
|
|
@ -109,5 +109,5 @@ container to random ports on the host.
|
|||
$ docker run -d -P --name webserver nginx
|
||||
```
|
||||
|
||||
See the [run command](/engine/reference/commandline/run.md) for more details on
|
||||
See the [run command](../engine/reference/commandline/run.md) for more details on
|
||||
publish options used with `docker run`.
|
||||
|
|
|
|||
|
|
@ -4,9 +4,8 @@ keywords: mac, osxfs, volumes
|
|||
title: Performance tuning for volume mounts (shared filesystems)
|
||||
---
|
||||
|
||||
[Docker 17.04 CE Edge](/edge/index.md#docker-ce-edge-new-features) adds support
|
||||
for two new flags to the [docker run `-v`,
|
||||
`--volume`](/engine/reference/run/#volume-shared-filesystems)
|
||||
[Docker 17.04 CE Edge](https://github.com/docker/docker.github.io/blob/v17.03/edge/index.md#docker-ce-edge-new-features) adds support
|
||||
for two new flags to the [docker run `-v`, `--volume`](../engine/reference/run.md#volume-shared-filesystems)
|
||||
option, `cached` and `delegated`, that can significantly improve the performance
|
||||
of mounted volume access on Docker Desktop for Mac. These options begin to solve some of
|
||||
the challenges discussed in
|
||||
|
|
@ -25,7 +24,7 @@ Performance](https://stories.amazee.io/docker-on-mac-performance-docker-machine-
|
|||
gives a nice, quick summary.
|
||||
|
||||
For information on how to configure these options in a Compose file, see
|
||||
[Caching options for volume mounts](/compose/compose-file/index.md#caching-options-for-volume-mounts-docker-desktop-for-mac)
|
||||
[Caching options for volume mounts](../compose/compose-file/index.md#caching-options-for-volume-mounts-docker-desktop-for-mac)
|
||||
the Docker Compose topics.
|
||||
|
||||
## Performance implications of host-container file system consistency
|
||||
|
|
@ -96,8 +95,8 @@ temporary discrepancies are allowed between container and host.
|
|||
|
||||
Each of these configurations (`consistent`, `cached`, `delegated`) can be
|
||||
specified as a suffix to the
|
||||
[`-v`](/engine/reference/run/#volume-shared-filesystems)
|
||||
option of [`docker run`](/engine/reference/run.md). For
|
||||
[`-v`](../engine/reference/run.md#volume-shared-filesystems)
|
||||
option of [`docker run`](../engine/reference/commandline/run.md). For
|
||||
example, to bind-mount `/Users/yallop/project` in a container under the path
|
||||
`/project`, you might run the following command:
|
||||
|
||||
|
|
|
|||
|
|
@ -63,7 +63,7 @@ By default, you can share files in `/Users/`, `/Volumes/`, `/private/`, and
|
|||
`/tmp` directly. To add or remove directory trees that are exported to Docker,
|
||||
use the **File sharing** tab in Docker preferences {: .inline} -> **Preferences** ->
|
||||
**File sharing**. (See [Preferences](/docker-for-mac/index.md#preferences-menu).)
|
||||
**File sharing**. (See [Preferences](index.md#file-sharing).)
|
||||
|
||||
All other paths
|
||||
used in `-v` bind mounts are sourced from the Moby Linux VM running the Docker
|
||||
|
|
@ -117,7 +117,7 @@ The following are **unsupported file system events**:
|
|||
* Open
|
||||
* Access
|
||||
* Close events
|
||||
* Unmount events (see <a href="osxfs.md#mounts">Mounts</a>)
|
||||
* Unmount events (see [Mounts](#mounts))
|
||||
|
||||
Some events may be delivered multiple times. These limitations do not apply to
|
||||
events between containers, only to those events originating in macOS.
|
||||
|
|
|
|||
|
|
@ -290,7 +290,7 @@ Docker Desktop Community 2.1.0.0 contains the following experimental features.
|
|||
- Linux Kernel 4.9.93 with CEPH, DRBD, RBD, MPLS_ROUTING and MPLS_IPTUNNEL enabled
|
||||
|
||||
* New
|
||||
- Kubernetes Support. You can now run a single-node Kubernetes cluster from the "Kubernetes" Pane in Docker For Mac Preferences and use kubectl commands as well as docker commands. See https://docs.docker.com/docker-for-mac/kubernetes/
|
||||
- Kubernetes Support. You can now run a single-node Kubernetes cluster from the "Kubernetes" Pane in Docker For Mac Preferences and use kubectl commands as well as docker commands. See [https://docs.docker.com/docker-for-mac/kubernetes/](kubernetes.md)
|
||||
- Add an experimental SOCKS server to allow access to container networks, see [docker/for-mac#2670](https://github.com/docker/for-mac/issues/2670#issuecomment-372365274). Also see [docker/for-mac#2721](https://github.com/docker/for-mac/issues/2721)
|
||||
- Re-enable raw as the default disk format for users running macOS 10.13.4 and higher. Note this change only takes effect after a "reset to factory defaults" or "remove all data" (from the Whale menu -> Preferences -> Reset). Related to [docker/for-mac#2625](https://github.com/docker/for-mac/issues/2625)
|
||||
|
||||
|
|
@ -366,7 +366,7 @@ Docker Desktop Community 2.1.0.0 contains the following experimental features.
|
|||
- Clearer error message when incompatible hardware is detected.
|
||||
- Fix some cases where selecting "Reset" after an error did not reset properly.
|
||||
- Fix incorrect NTP config. Fixes [docker/for-mac#2529](https://github.com/docker/for-mac/issues/2529)
|
||||
- Migration of Docker Toolbox images is not proposed anymore in Docker For Mac installer (still possible to [migrate Toolbox images manually](https://docs.docker.com/docker-for-mac/docker-toolbox/#migrating-from-docker-toolbox-to-docker-for-mac) ).
|
||||
- Migration of Docker Toolbox images is not proposed anymore in Docker For Mac installer (still possible to [migrate Toolbox images manually](docker-toolbox.md#migrating-from-docker-toolbox-to-docker-desktop-on-mac) ).
|
||||
|
||||
### Docker Community Edition 17.12.0-ce-mac55 2018-02-27
|
||||
|
||||
|
|
|
|||
|
|
@ -62,8 +62,7 @@ Choose {: .inline} > **Troubleshoot** > **Run D
|
|||
Once the diagnostics are available, you can upload them and obtain a
|
||||
**Diagnostic ID**, which must be provided when communicating with the Docker
|
||||
team. For more information on our policy regarding personal data, see
|
||||
[how is personal data handled in Docker
|
||||
Desktop](https://docs.docker.com/docker-for-mac/faqs/#how-is-personal-data-handled-in-docker-desktop).
|
||||
[how is personal data handled in Docker Desktop](faqs.md#how-is-personal-data-handled-in-docker-desktop).
|
||||
|
||||
{:width="600px"}
|
||||
|
|
@ -109,8 +108,8 @@ $ open /tmp/BE9AFAAF-F68B-41D0-9D12-84760E6B8740/20190905152051.zip
|
|||
|
||||
In addition to using the diagnose and feedback option to submit logs, you can
|
||||
browse the logs yourself. The following documentation is about macOS 10.12
|
||||
onwards; for older versions, see [older
|
||||
documentation](v17.12/docker-for-mac/troubleshoot/#logs).
|
||||
onwards; for older versions, see
|
||||
[older documentation](https://github.com/docker/docker.github.io/blob/v17.12/docker-for-mac/troubleshoot.md#check-the-logs).
|
||||
|
||||
#### In a terminal
|
||||
|
||||
|
|
@ -176,7 +175,7 @@ in the FAQs.
|
|||
|
||||
If you are using mounted volumes and get runtime errors indicating an
|
||||
application file is not found, access to a volume mount is denied, or a service
|
||||
cannot start, such as when using [Docker Compose](/compose/gettingstarted.md),
|
||||
cannot start, such as when using [Docker Compose](../compose/gettingstarted.md),
|
||||
you might need to enable [file sharing](index.md#file-sharing).
|
||||
|
||||
Volume mounting requires shared drives for projects that live outside of the
|
||||
|
|
|
|||
|
|
@ -16,9 +16,9 @@ The Docker Desktop Dashboard offers the following benefits:
|
|||
|
||||
In addition, the Dashboard UI allows you to:
|
||||
|
||||
- Navigate to the [Settings](/docker-for-windows/index/#docker-settings-dialog) menu to configure Docker Desktop preferences
|
||||
- Navigate to the [Settings](index.md#docker-settings-dialog) menu to configure Docker Desktop preferences
|
||||
- Access the [Troubleshoot](troubleshoot.md) menu to debug and perform restart operations
|
||||
- Sign into [Docker Hub](/docker-for-windows/index/#docker-hub) using your Docker ID
|
||||
- Sign into [Docker Hub](index.md#docker-hub) using your Docker ID
|
||||
|
||||
To access the Docker Desktop Dashboard, from the Docker menu, select **Dashboard**. The Dashboard provides a runtime view of all your containers and applications.
|
||||
|
||||
|
|
|
|||
|
|
@ -26,11 +26,11 @@ Docker Engine. Bugs, crashes, and issues can occur when using the Edge version,
|
|||
|
||||
### Can I switch between Stable and Edge versions of Docker Desktop?
|
||||
|
||||
Yes, you can switch between Stable and Edge versions. You can try out the Edge releases to see what's new, then go back to Stable for other work. However, **you can only have one version of Docker Desktop installed at a time**. For more information, see [Switch between Stable and Edge versions](/docker-for-windows/install/#switch-between-stable-and-edge-versions).
|
||||
Yes, you can switch between Stable and Edge versions. You can try out the Edge releases to see what's new, then go back to Stable for other work. However, **you can only have one version of Docker Desktop installed at a time**. For more information, see [Switch between Stable and Edge versions](install.md#switch-between-stable-and-edge-versions).
|
||||
|
||||
## What are the system requirements for Docker Desktop?
|
||||
|
||||
For information about system requirements, see [Docker Desktop Windows system requirements](install/#system-requirements).
|
||||
For information about system requirements, see [Docker Desktop Windows system requirements](install.md#system-requirements).
|
||||
|
||||
## What is an experimental feature?
|
||||
|
||||
|
|
@ -49,7 +49,7 @@ On Docker Desktop, clients can connect to the Docker Engine through a
|
|||
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 Desktop for Windows forums topic [How to find the remote API](https://forums.docker.com/t/how-to-find-the-remote-api/20988){: target="_blank" class="_"}.
|
||||
See also [Docker Engine API](../engine/api/index.md) and the Docker Desktop for Windows forums topic [How to find the remote API](https://forums.docker.com/t/how-to-find-the-remote-api/20988){: target="_blank" class="_"}.
|
||||
|
||||
### How do I connect from a container to a service on the host?
|
||||
|
||||
|
|
@ -58,28 +58,28 @@ Windows has a changing IP address (or none if you have no network access). We re
|
|||
The gateway is also reachable as `gateway.docker.internal`.
|
||||
|
||||
For more information about the networking features in Docker Desktop for Windows, see
|
||||
[Networking](/docker-for-windows/networking/).
|
||||
[Networking](networking.md).
|
||||
|
||||
### How do I connect to a container from Windows?
|
||||
|
||||
We recommend that you publish a port, or connect from another container. You can use the same method on Linux if the container is on an overlay network and not a bridge network, as these are not routed.
|
||||
|
||||
For more information and examples, see
|
||||
[I want to connect to a container from Windows](networking.md#i-want-to-connect-to-a-container-from-windows) in the [Networking](/docker-for-windows/networking/) topic.
|
||||
[I want to connect to a container from Windows](networking.md#i-want-to-connect-to-a-container-from-windows) in the [Networking](networking.md) topic.
|
||||
|
||||
## Volumes
|
||||
|
||||
### Can I change permissions on shared volumes for container-specific deployment requirements?
|
||||
|
||||
No, at this point, Docker Desktop does not enable you to control (`chmod`)
|
||||
the Unix-style permissions on [shared volumes](/docker-for-windows#shared-drives) for
|
||||
the Unix-style permissions on [shared volumes](index.md#file-sharing) for
|
||||
deployed containers, but rather sets permissions to a default value of
|
||||
[0777](http://permissions-calculator.org/decode/0777/){: target="_blank" class="_"}
|
||||
(`read`, `write`, `execute` permissions for `user` and for
|
||||
`group`) which is not configurable.
|
||||
|
||||
For workarounds and to learn more, see
|
||||
[Permissions errors on data directories for shared volumes](troubleshoot#permissions-errors-on-data-directories-for-shared-volumes).
|
||||
[Permissions errors on data directories for shared volumes](troubleshoot.md#permissions-errors-on-data-directories-for-shared-volumes).
|
||||
|
||||
### How do symlinks work on Windows?
|
||||
|
||||
|
|
@ -96,11 +96,11 @@ Docker Desktop supports all trusted Certificate Authorities (CAs) (root or
|
|||
intermediate). Docker recognizes certs stored under Trust Root
|
||||
Certification Authorities or Intermediate Certification Authorities.
|
||||
|
||||
For more information on adding server and client side certs, see [Add TLS certificates](/docker-for-windows/index/#add-tls-certificates) in the Getting Started topic.
|
||||
For more information on adding server and client side certs, see [Adding TLS certificates](index.md#adding-tls-certificates) in the Getting Started topic.
|
||||
|
||||
### How do I add client certificates?
|
||||
|
||||
For information on adding client certificates, see [Add TLS certificates](/docker-for-windows/index/#add-tls-certificates) in the Getting Started topic.
|
||||
For information on adding client certificates, see [Adding TLS certificates](index.md#adding-tls-certificates) in the Getting Started topic.
|
||||
|
||||
### Can I pass through a USB device to a container?
|
||||
|
||||
|
|
@ -125,7 +125,7 @@ You can find a tutorial about running Windows containers on Windows Server in
|
|||
|
||||
### Can I install Docker Desktop on Windows 10 Home?
|
||||
|
||||
Windows 10 Insider Preview (Windows 10 Home) users can now install [Docker Desktop Edge 2.2.2.0](https://download.docker.com/win/edge/43066/Docker%20Desktop%20Installer.exe) or a later release with the [experimental WSL 2 support](/docker-for-windows/wsl-tech-preview/). This requires Windows Insider Preview Build 19018 or later.
|
||||
Windows 10 Insider Preview (Windows 10 Home) users can now install [Docker Desktop Edge 2.2.2.0](https://download.docker.com/win/edge/43066/Docker%20Desktop%20Installer.exe) or a later release with the [experimental WSL 2 support](wsl-tech-preview.md). This requires Windows Insider Preview Build 19018 or later.
|
||||
|
||||
Docker Desktop Stable releases require the Hyper-V feature which is not available in the Windows 10 Home edition.
|
||||
|
||||
|
|
@ -136,7 +136,7 @@ Docker Desktop uses the Windows Hyper-V features. While older Windows versions h
|
|||
### Why does Docker Desktop fail to start when anti-virus software is installed?
|
||||
|
||||
Some anti-virus software may be incompatible with Hyper-V and Windows 10 builds which impact Docker
|
||||
Desktop. For more information, see [Docker Desktop fails to start when anti-virus software is installed](/docker-for-windows/troubleshoot/#docker-desktop-fails-to-start-when-anti-virus-software-is-installed)
|
||||
Desktop. For more information, see [Docker Desktop fails to start when anti-virus software is installed](troubleshoot.md#docker-desktop-fails-to-start-when-anti-virus-software-is-installed)
|
||||
in [Troubleshooting](troubleshoot.md).
|
||||
|
||||
## Feedback
|
||||
|
|
@ -150,7 +150,7 @@ functionality you'd like to see added.
|
|||
|
||||
### What if I have problems or questions?
|
||||
|
||||
You can find information about diagnosing and troubleshooting common issues in the [Logs and Troubleshooting](troubleshoot) topic.
|
||||
You can find information about diagnosing and troubleshooting common issues in the [Logs and Troubleshooting](troubleshoot.md) topic.
|
||||
|
||||
If you do not find a solution in Troubleshooting, browse issues on
|
||||
[Docker Desktop for Windows issues on GitHub](https://github.com/docker/for-win/issues){: target="_blank" class="_"}
|
||||
|
|
|
|||
|
|
@ -240,8 +240,8 @@ Note that configuring file sharing is not necessary for Windows containers, only
|
|||
>
|
||||
* Shared drives are designed to allow application code to be edited on the host while being executed in containers. For non-code items
|
||||
such as cache directories or databases, the performance will be much better if they are stored in
|
||||
the Linux VM, using a [data volume](/engine/tutorials/dockervolumes.md#data-volumes)
|
||||
(named volume) or [data container](/engine/tutorials/dockervolumes.md#creating-and-mounting-a-data-volume-container).
|
||||
the Linux VM, using a [data volume](../storage/volumes.md)
|
||||
(named volume) or [data container](../storage/volumes.md).
|
||||
>
|
||||
* Docker Desktop sets permissions to read/write/execute for users, groups and others [0777 or a+rwx](http://permissions-calculator.org/decode/0777/).
|
||||
This is not configurable. See [Permissions errors on data directories for shared volumes](troubleshoot.md#permissions-errors-on-data-directories-for-shared-volumes).
|
||||
|
|
@ -308,7 +308,7 @@ Updating these settings requires a reconfiguration and reboot of the Linux VM.
|
|||
The Docker Engine page allows you to configure the Docker daemon to determine how your containers run.
|
||||
|
||||
Type a JSON configuration file in the box to configure the daemon settings. For a full list of options, see the Docker Engine
|
||||
[dockerd commandline reference](/engine/reference/commandline/dockerd.md){:target="_blank"
|
||||
[dockerd commandline reference](/engine/reference/commandline/dockerd/){:target="_blank"
|
||||
class="_"}.
|
||||
|
||||
Click **Apply & Restart** to save your settings and restart Docker Desktop.
|
||||
|
|
@ -465,10 +465,10 @@ The Docker Desktop Dashboard enables you to interact with containers and applica
|
|||
|
||||
Select **Sign in /Create Docker ID** from the Docker Desktop menu to access your [Docker Hub](https://hub.docker.com/){: target="_blank" class="_" } account. Once logged in, you can access your Docker Hub repositories directly from the Docker Desktop menu.
|
||||
|
||||
For more information, refer to the following [Docker Hub topics](/docker-hub/index.md){: target="_blank" class="_" }:
|
||||
For more information, refer to the following [Docker Hub topics](../docker-hub/index.md){: target="_blank" class="_" }:
|
||||
|
||||
* [Organizations and Teams in Docker Hub](/docker-hub/orgs.md){: target="_blank" class="_" }
|
||||
* [Builds and Images](/docker-cloud/builds/index.md){: target="_blank" class="_" }
|
||||
* [Organizations and Teams in Docker Hub](../docker-hub/orgs.md){: target="_blank" class="_" }
|
||||
* [Builds and Images](../docker-hub/builds/index.md){: target="_blank" class="_" }
|
||||
|
||||
### Two-factor authentication
|
||||
|
||||
|
|
@ -522,19 +522,19 @@ You need to restart Docker Desktop after making any changes to the keychain
|
|||
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 Daemon](/docker-for-windows#daemon)). Docker Desktop ignores
|
||||
[Docker Daemon](#docker-engine)). Docker Desktop ignores
|
||||
certificates listed under insecure registries, and does not send client
|
||||
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.
|
||||
|
||||
To learn more about how to set the client TLS certificate for verification, see
|
||||
[Verify repository client with certificates](/engine/security/certificates)
|
||||
[Verify repository client with certificates](../engine/security/certificates.md)
|
||||
in the Docker Engine topics.
|
||||
|
||||
## Where to go next
|
||||
|
||||
* Try out the walkthrough at [Get Started](/get-started/){: target="_blank" class="_"}.
|
||||
* Try out the walkthrough at [Get Started](../get-started/index.md){: target="_blank" class="_"}.
|
||||
|
||||
* Dig in deeper with [Docker Labs](https://github.com/docker/labs/) example walkthroughs and source code.
|
||||
|
||||
* Refer to the [Docker CLI Reference Guide](/engine/api.md){: target="_blank" class="_"}.
|
||||
* Refer to the [Docker CLI Reference Guide](/engine/reference/commandline/cli/){: target="_blank" class="_"}.
|
||||
|
|
|
|||
|
|
@ -39,9 +39,9 @@ used side-by-side with Docker Desktop. However, you can still use
|
|||
|
||||
### What's included in the installer
|
||||
|
||||
The Docker Desktop installation includes [Docker Engine](/engine/index.md),
|
||||
Docker CLI client, [Docker Compose](/compose/index.md),
|
||||
[Notary](/notary/getting_started.md),
|
||||
The Docker Desktop installation includes [Docker Engine](../engine/index.md),
|
||||
Docker CLI client, [Docker Compose](../compose/index.md),
|
||||
[Notary](../notary/getting_started.md),
|
||||
[Kubernetes](https://github.com/kubernetes/kubernetes/),
|
||||
and [Credential Helper](https://github.com/docker/docker-credential-helpers/).
|
||||
|
||||
|
|
@ -59,7 +59,7 @@ more information, see [Running Docker Desktop in nested virtualization scenarios
|
|||
|
||||
Looking for information on using Windows containers?
|
||||
|
||||
* [Switch between Windows and Linux containers](/docker-for-windows/index.md#switch-between-windows-and-linux-containers)
|
||||
* [Switch between Windows and Linux containers](index.md#switch-between-windows-and-linux-containers)
|
||||
describes how you can toggle between Linux and Windows containers in Docker Desktop and points you to the tutorial mentioned above.
|
||||
* [Getting Started with Windows Containers (Lab)](https://github.com/docker/labs/blob/master/windows/windows-containers/README.md)
|
||||
provides a tutorial on how to set up and run Windows containers on Windows 10, Windows Server 2016 and Windows Server 2019. It shows you how to use a MusicStore application
|
||||
|
|
@ -95,7 +95,7 @@ When the whale icon in the status bar stays steady, Docker Desktop is up-and-run
|
|||
|
||||
|
||||
If the whale icon is hidden in the Notifications area, click the up arrow on the
|
||||
taskbar to show it. To learn more, see [Docker Settings](/docker-for-windows/index.md#docker-settings-dialog).
|
||||
taskbar to show it. To learn more, see [Docker Settings](index.md#docker-settings-dialog).
|
||||
|
||||
After installing the Docker Desktop app, you also get a pop-up success message with
|
||||
suggested next steps, and a link to this documentation.
|
||||
|
|
|
|||
|
|
@ -108,5 +108,5 @@ container to random ports on the host.
|
|||
$ docker run -d -P --name webserver nginx
|
||||
```
|
||||
|
||||
See the [run command](/engine/reference/commandline/run.md) for more details on
|
||||
See the [run command](../engine/reference/commandline/run.md) for more details on
|
||||
publish options used with `docker run`.
|
||||
|
|
|
|||
|
|
@ -86,7 +86,7 @@ For information about Edge releases, see the [Edge release notes](edge-release-n
|
|||
- Fixed a race condition when starting the WSL engine which caused Docker Desktop to incorrectly report that the containers have exited. Fixes [docker/for-win#5607](https://github.com/docker/for-win/issues/5607).
|
||||
- Fixed an issue where editing code inside a container resulted in an error. Fixes [docker/for-win#5528](https://github.com/docker/for-win/issues/5528).
|
||||
- Fixed a bug where running the command `DockerCli.exe -SharedDrives` failed to display a list of drives that are shared. Fixes [docker/for-win#5625](https://github.com/docker/for-win/issues/5625).
|
||||
- Starting with Docker Desktop 2.2.0.3, you must access all shared files using their original case. For example, if you have created a file called `test`, you must open it as `test`. Attempts to open the file as `Test` will fail with the error `No such file or directory`. For more information, see _Tips on shared drives, permissions, and volume mounts_ in [File sharing](/docker-for-windows/index/#file-sharing).
|
||||
- Starting with Docker Desktop 2.2.0.3, you must access all shared files using their original case. For example, if you have created a file called `test`, you must open it as `test`. Attempts to open the file as `Test` will fail with the error `No such file or directory`. For more information, see _Tips on shared drives, permissions, and volume mounts_ in [File sharing](index.md#file-sharing).
|
||||
|
||||
### Known issues
|
||||
|
||||
|
|
|
|||
|
|
@ -22,7 +22,7 @@ The Troubleshoot page contains the following options:
|
|||
|
||||
* **Run Diagnostics**: Select this option to diagnose any issues on Docker Desktop. For detailed information about diagnostics, see [Diagnose problems, send feedback, and create GitHub issues](#diagnose-problems-send-feedback-and-create-github-issues).
|
||||
|
||||
* **Reset Kubernetes cluster**: Select this option to delete all stacks and Kubernetes resources. For more information, see [Kubernetes](/docker-for-windows/index/#kubernetes).
|
||||
* **Reset Kubernetes cluster**: Select this option to delete all stacks and Kubernetes resources. For more information, see [Kubernetes](index.md#kubernetes).
|
||||
|
||||
* **Reset to factory defaults**: Choose this option to reset all options on
|
||||
Docker Desktop to their initial state, the same as when Docker Desktop was first installed.
|
||||
|
|
@ -125,7 +125,7 @@ in the FAQs.
|
|||
|
||||
If you are using mounted volumes and get runtime errors indicating an
|
||||
application file is not found, access is denied to a volume mount, or a service
|
||||
cannot start, such as when using [Docker Compose](/compose/gettingstarted.md),
|
||||
cannot start, such as when using [Docker Compose](../compose/gettingstarted.md),
|
||||
you might need to enable [shared drives](index.md#shared-drives).
|
||||
|
||||
Volume mounting requires shared drives for Linux containers (not for Windows
|
||||
|
|
@ -183,15 +183,15 @@ In the subsequent screen, verify that Hyper-V is enabled:
|
|||
|
||||
The Docker Desktop installation includes 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
|
||||
and the [Microsoft Hyper-V driver](../machine/drivers/hyper-v.md) to create local
|
||||
virtual machines. _This is tangential to using Docker Desktop_, but if you want to use Docker Machine
|
||||
to create multiple local Virtual Machines (VMs), or to provision remote machines, see the
|
||||
[Docker Machine](/machine/index.md) topics. This is documented only for users looking for information about Docker Machine on Windows, which requires that Hyper-V is enabled, an external network switch is active, and referenced in the flags for the `docker-machine create` command
|
||||
as described in the [Docker Machine driver example](/machine/drivers/hyper-v.md#example).
|
||||
[Docker Machine](../machine/index.md) topics. This is documented only for users looking for information about Docker Machine on Windows, which requires that Hyper-V is enabled, an external network switch is active, and referenced in the flags for the `docker-machine create` command
|
||||
as described in the [Docker Machine driver example](../machine/drivers/hyper-v.md#example).
|
||||
|
||||
#### Virtualization must be enabled
|
||||
|
||||
In addition to [Hyper-V](#hyper-v) or [WSL 2](/docker-for-windows/wsl-tech-preview.md), virtualization must be enabled. Check the
|
||||
In addition to [Hyper-V](#hyper-v) or [WSL 2](wsl-tech-preview.md), virtualization must be enabled. Check the
|
||||
Performance tab on the Task Manager:
|
||||
|
||||
{:width="700px"}
|
||||
|
|
@ -224,9 +224,9 @@ Here are some steps to take if you experience similar problems:
|
|||
|
||||
|
||||
4. Set up an external network switch. If you plan at any point to use
|
||||
[Docker Machine](/machine/overview.md) to set up multiple local VMs, you
|
||||
[Docker Machine](../machine/overview.md) to set up multiple local VMs, you
|
||||
need this anyway, as described in the topic on the
|
||||
[Hyper-V driver for Docker Machine](/machine/drivers/hyper-v.md#example).
|
||||
[Hyper-V driver for Docker Machine](../machine/drivers/hyper-v.md#example).
|
||||
You can replace `DockerNAT` with this switch.
|
||||
|
||||
5. If previous steps fail to solve the problems, follow steps on the
|
||||
|
|
@ -241,7 +241,7 @@ Here are some steps to take if you experience similar problems:
|
|||
### Windows containers and Windows Server
|
||||
|
||||
Docker Desktop is not supported on Windows Server. Instead, you can use
|
||||
[Docker Enterprise Basic](/ee/index.md) at no additional cost.
|
||||
Docker Enterprise Basic at no additional cost.
|
||||
|
||||
If you have questions about how to run Windows containers on Windows 10, see
|
||||
[Switch between Windows and Linux containers](index.md#switch-between-windows-and-linux-containers).
|
||||
|
|
@ -284,7 +284,7 @@ Linux containers).
|
|||
To reach a Windows container from the local host, you need to specify the IP
|
||||
address and port for the container that is running the service.
|
||||
|
||||
You can get the container IP address by using [`docker inspect`](/engine/reference/commandline/inspect.md) with some `--format` options
|
||||
You can get the container IP address by using [`docker inspect`](../engine/reference/commandline/inspect.md) with some `--format` options
|
||||
and the ID or name of the container. For the example above, the command would
|
||||
look like this, using the name we gave to the container (`webserver`) instead of
|
||||
the container ID:
|
||||
|
|
|
|||
Loading…
Reference in New Issue