Repair links (#6505)

This commit is contained in:
Gwendolynne Barr 2018-04-20 14:54:39 -07:00 committed by GitHub
parent 6343cf8355
commit 1c752a8c0b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 27 additions and 33 deletions

View File

@ -7,8 +7,8 @@ title: Frequently asked questions (FAQ)
--- ---
**Looking for popular FAQs on Docker for Mac?** Check out the **Looking for popular FAQs on Docker for Mac?** Check out the
[Docker Knowledge Hub](http://success.docker.com/) for knowledge base articles, [Docker Success Center](http://success.docker.com/){: target="_blank" class="_"}
FAQs, technical support for various subscription levels, and more. for knowledge base articles, FAQs, technical support for subscription levels, and more.
## Questions about Docker.app ## Questions about Docker.app
### Stable and Edge channels ### Stable and Edge channels
@ -16,7 +16,7 @@ FAQs, technical support for various subscription levels, and more.
**Q: How do I get the Stable or Edge version of Docker for Mac?** **Q: How do I get the Stable or Edge version of Docker for Mac?**
A: Use the download links for the channels given in the topic A: Use the download links for the channels given in the topic
[Download Docker for Mac](install.md#download-docker-for-mac). [Download Docker for Mac](install.md#download-docker-for-mac){: target="_blank" class="_"}.
This topic also has more information about the two channels. This topic also has more information about the two channels.
@ -60,11 +60,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 [export](/engine/reference/commandline/export) in the Docker Engine
command line reference.) command line reference.)
3. Uninstall the current app (whether Stable or Edge). 3. Uninstall the current app (whether Stable or Edge).
@ -82,13 +82,13 @@ required**_.
You need a Mac that supports hardware virtualization and can run at You need a Mac that supports hardware virtualization and can run at
least macOS `10.10.3+` or `10.11` (macOS Yosemite or macOS El Capitan). See also least macOS `10.10.3+` or `10.11` (macOS Yosemite or macOS El Capitan). See also
[What to know before you install](install.md#what-to-know-before-you-install) in [What to know before you install](install#what-to-know-before-you-install) in
the install guide. the install guide.
### Do I need to reinstall Docker for Mac if I change the name of my macOS account? ### Do I need to reinstall Docker for Mac if I change the name of my macOS account?
Yes, if you [change the name of your macOS user account and home Yes, if you [change the name of your macOS user account and home
folder](https://support.apple.com/en-us/HT201548) after Docker for Mac is folder](https://support.apple.com/en-us/HT201548){: target="_blank" class="_"} after Docker for Mac is
already installed, you need to uninstall and reinstall Docker for Mac. Otherwise, Docker for Mac fails to start. See also, already installed, you need to uninstall and reinstall Docker for Mac. Otherwise, Docker for Mac fails to start. See also,
[Docker for Mac does not start if Mac user account and home folder are renamed after installing Docker for Mac](troubleshoot.md#docker-for-mac-does-not-start-if-mac-user-account-and-home-folder-are-renamed-after-installing-the-app) in Troubleshooting. [Docker for Mac does not start if Mac user account and home folder are renamed after installing Docker for Mac](troubleshoot.md#docker-for-mac-does-not-start-if-mac-user-account-and-home-folder-are-renamed-after-installing-the-app) in Troubleshooting.
@ -110,10 +110,8 @@ to talk to Docker for Mac. The same applies to `docker-compose`.
You might decide that you do not need Toolbox now that you have Docker for Mac, You might decide that you do not need Toolbox now that you have Docker for Mac,
and want to uninstall it. For details on how to perform a clean uninstall of and want to uninstall it. For details on how to perform a clean uninstall of
Toolbox on the Mac, see [How to uninstall Toolbox on the Mac, see [How to uninstall Toolbox](/toolbox/toolbox_install_mac/#how-to-uninstall-toolbox)
Toolbox](/toolbox/toolbox_install_mac.md#how-to-uninstall-toolbox) in the in the Toolbox Mac topics.
Toolbox Mac topics.
## Questions about feedback and help ## Questions about feedback and help
### What kind of feedback are we looking for? ### What kind of feedback are we looking for?
@ -133,12 +131,12 @@ You can find the list of frequent issues in
[Logs and Troubleshooting](troubleshoot.md). [Logs and Troubleshooting](troubleshoot.md).
If you do not find a solution in Troubleshooting, browse issues on If you do not find a solution in Troubleshooting, browse issues on
[Docker for Mac issues on GitHub](https://github.com/docker/for-mac/issues) or [Docker for Mac issues on GitHub](https://github.com/docker/for-mac/issues){: target="_blank" class="_"} or
create a new one. You can also create new issues based on diagnostics. To learn more, create a new one. You can also create new issues based on diagnostics. To learn more,
see see
[Diagnose problems, send feedback, and create GitHub issues](troubleshoot.md#diagnose-problems-send-feedback-and-create-github-issues). [Diagnose problems, send feedback, and create GitHub issues](troubleshoot.md#diagnose-problems-send-feedback-and-create-github-issues).
[Docker for Mac forum](https://forums.docker.com/c/docker-for-mac) [Docker for Mac forum](https://forums.docker.com/c/docker-for-mac){: 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.
@ -169,13 +167,12 @@ On Docker for Mac, clients can connect to the Docker Engine through a Unix
socket: `unix:///var/run/docker.sock`. socket: `unix:///var/run/docker.sock`.
See also [Docker Engine API](/engine/api.md) and Docker for Mac forums topic See also [Docker Engine API](/engine/api.md) and Docker for Mac forums topic
[Using pycharm Docker [Using pycharm Docker plugin..](https://forums.docker.com/t/using-pycharm-docker-plugin-with-docker-beta/8617){: target="_blank" class="_"}.
plugin..](https://forums.docker.com/t/using-pycharm-docker-plugin-with-docker-beta/8617).
If you are working with applications like [Apache If you are working with applications like [Apache Maven](https://maven.apache.org/){: target="_blank" class="_"}
Maven](https://maven.apache.org/) that expect settings for `DOCKER_HOST` and that expect settings for `DOCKER_HOST` and `DOCKER_CERT_PATH` environment
`DOCKER_CERT_PATH` environment variables, specify these to connect to Docker variables, specify these to connect to Docker instances through Unix sockets.
instances through Unix sockets. For example: For example:
```bash ```bash
export DOCKER_HOST=unix:///var/run/docker.sock export DOCKER_HOST=unix:///var/run/docker.sock
@ -210,9 +207,8 @@ in the Networking topic.
Starting with Docker for Mac Beta 27 and Stable 1.12.3, all trusted certificate Starting with Docker for Mac Beta 27 and Stable 1.12.3, all trusted certificate
authorities (CAs) (root or intermediate) are supported. authorities (CAs) (root or intermediate) are supported.
For full information on adding server and client side certs, see [Add For full information on adding server and client side certs, see
TLS certificates](index.md#add-tls-certificates) in [Add TLS certificates](index.md#add-tls-certificates) in the Getting Started topic.
the Getting Started topic.
### How do I add client certificates? ### How do I add client certificates?
@ -221,9 +217,8 @@ certificates with `git` commands anymore. You can put your client certificates
in `~/.docker/certs.d/<MyRegistry>:<Port>/client.cert` and in `~/.docker/certs.d/<MyRegistry>:<Port>/client.cert` and
`~/.docker/certs.d/<MyRegistry>:<Port>/client.key`. `~/.docker/certs.d/<MyRegistry>:<Port>/client.key`.
For full information on adding server and client side certs, see [Add For full information on adding server and client side certs, see
TLS certificates](index.md#add-tls-certificates) in [Add TLS certificates](index.md#add-tls-certificates) in the Getting Started topic.
the Getting Started topic.
### Can I pass through a USB device to a container? ### Can I pass through a USB device to a container?
@ -231,7 +226,6 @@ Unfortunately it is not possible to pass through a USB device (or a
serial port) to a container. For use cases requiring this, we serial port) to a container. For use cases requiring this, we
recommend the use of [Docker Toolbox](/toolbox/overview.md). recommend the use of [Docker Toolbox](/toolbox/overview.md).
## Disk Usage ## Disk Usage
### What is the disk image? ### What is the disk image?
@ -251,12 +245,12 @@ Qcow2 format (`Docker.qcow2`).
### Docker.raw consumes an insane amount of disk space! ### Docker.raw consumes an insane amount of disk space!
This is an illusion. Docker uses the raw format on Macs running the This is an illusion. Docker uses the raw format on Macs running the Apple
Apple Filesystem (APFS). APFS supports _sparse files_, which compress Filesystem (APFS). APFS supports _sparse files_, which compress long runs of
long runs of zeroes representing unused space. The output of `ls` is zeroes representing unused space. The output of `ls` is misleading, because it
misleading, because it lists the logical size of the file rather than lists the logical size of the file rather than its physical size. To see the
its physical size. To see the physical size, add the `-ks` switch; to physical size, add the `-ks` switch; to see the logical size in human readable
see the logical size in human readable form, add `-lh`: form, add `-lh`:
```bash ```bash
$ cd ~/Library/Containers/com.docker.docker/Data $ cd ~/Library/Containers/com.docker.docker/Data
@ -309,7 +303,7 @@ takes longer than usual to restart because it must wait for the
compaction to complete. compaction to complete.
For background conversation thread on this, see For background conversation thread on this, see
[Docker.qcow2 never shrinks ..](https://github.com/docker/for-mac/issues/371) [Docker.qcow2 never shrinks...](https://github.com/docker/for-mac/issues/371)
on Docker for Mac GitHub issues. on Docker for Mac GitHub issues.