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

Mac: give some structure to the FAQ (#5503) 

This commit reorders this

    ### Stable and Edge channels
    ### What is Docker.app?
    ### What kind of feedback are we looking for?
    ### What if I have problems or questions?
    ### How can I opt out of sending my usage data?
    ### Can I use Docker for Mac with new swarm mode?
    ### How do I connect to the remote Docker Engine API?
    ### How do I connect from a container to a service on the host?
    ### How do I connect to a container from the Mac?
    ### How do I add custom CA certificates?
    ### How do I add client certificates?
    ### How do I reduce the size of Docker.qcow2?
    ### What are system requirements for Docker for Mac?
    ### Do I need to reinstall Docker for Mac if I change the name of my macOS account?
    ### Do I need to uninstall Docker Toolbox to use Docker for Mac?
    ### How do I uninstall Docker Toolbox?
    ### What is HyperKit?
    ### What is the benefit of HyperKit?
    ### Why is com.docker.vmnetd running after I quit the app?
    ### Can I pass through a USB device to a container?

into this

    ## Questions about Docker.app
    ### Stable and Edge channels
    ### What is Docker.app?
    ### What are system requirements for Docker for Mac?
    ### Do I need to reinstall Docker for Mac if I change the name of my macOS account?
    ### Do I need to uninstall Docker Toolbox to use Docker for Mac?
    ### How do I uninstall Docker Toolbox?
    ## Questions about feedback and help
    ### What kind of feedback are we looking for?
    ### What if I have problems or questions?
    ### How can I opt out of sending my usage data?
    ## How can I...?
    ### Can I use Docker for Mac with swarm mode?
    ### How do I connect to the remote Docker Engine API?
    ### How do I connect from a container to a service on the host?
    ### How do I connect to a container from the Mac?
    ### How do I add custom CA certificates?
    ### How do I add client certificates?
    ### How do I reduce the size of Docker.qcow2?
    ### Can I pass through a USB device to a container?
    ## Components of Docker for Mac
    ### What is HyperKit?
    ### What is the benefit of HyperKit?
    ### Why is com.docker.vmnetd running after I quit the app?

Also, change "new swarm mode" into "swarm mode".

Signed-off-by: Akim Demaille <akim.demaille@gmail.com>
This commit is contained in:
Akim Demaille 2017-12-16 01:34:27 +01:00 committed by Misty Stanley-Jones
parent 2bf0f7221f
commit acfc69ecc3
1 changed files with 47 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

88
docker-for-mac/faqs.md
View File

@ -10,6 +10,7 @@ title: Frequently asked questions (FAQ)
[Docker Knowledge Hub](http://success.docker.com/) for knowledge base articles,
FAQs, technical support for various subscription levels, and more.
## Questions about Docker.app
### Stable and Edge channels
**Q: How do I get the Stable or Edge version of Docker for Mac?**
@ -77,6 +78,44 @@ Do the following each time:
and higher) to run containers, meaning that _**no separate VirtualBox is
required**_.
### What are system requirements for Docker for Mac?
Note that 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
[What to know before you install](install.md#what-to-know-before-you-install) in
the install guide.
### 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
folder](https://support.apple.com/en-us/HT201548) after Docker for Mac is
already installed, you need to uninstall and reinstall Docker for Mac. Otherwise, Docker for Mac will fail to start. See also,
[Docker for Mac will not start if Mac user account and home folder are renamed after installing Docker for Mac](troubleshoot.md#docker-for-mac-will-not-start-if-mac-user-account-and-home-folder-are-renamed-after-installing-the-app) in Troubleshooting.
### Do I need to uninstall Docker Toolbox to use Docker for Mac?
No, you can use these side by side. Docker Toolbox leverages a Docker daemon
installed using `docker-machine` in a machine called `default`. Running `eval
$(docker-machine env default)` in a shell sets DOCKER environment variables
locally to connect to the default machine using Engine from Toolbox. To check
whether Toolbox DOCKER environment variables are set, run `env | grep DOCKER`.
To make the client talk to the Docker for Mac Engine, run the command `unset
${!DOCKER_*}` to unset all DOCKER environment variables in the current shell.
(Now, `env | grep DOCKER` should return no output.) You can have multiple
command line shells open, some set to talk to Engine from Toolbox and others set
to talk to Docker for Mac. The same applies to `docker-compose`.
### How do I uninstall Docker Toolbox?
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
Toolbox on the Mac, see [How to uninstall
Toolbox](/toolbox/toolbox_install_mac.md#how-to-uninstall-toolbox) in the
Toolbox Mac topics.
## Questions about feedback and help
### What kind of feedback are we looking for?
Everything is fair game. We'd like your impressions on the download-install
@ -109,7 +148,9 @@ response.
If you do not want auto-send of usage data, use the Stable channel. For more
information, see [Stable and Edge channels](#stable-and-edge-channels) ("What is the difference between the Stable and Edge versions of Docker for Mac?").
### Can I use Docker for Mac with new swarm mode?
## How can I...?
### Can I use Docker for Mac with swarm mode?
Yes, you can use Docker for Mac to test single-node features of [swarm
mode](/engine/swarm/index.md) introduced with Docker Engine 1.12, including
@ -260,42 +301,13 @@ For background conversation thread on this, see
[Docker.qcow2 never shrinks ..](https://github.com/docker/for-mac/issues/371)
on Docker for Mac GitHub issues.
### What are system requirements for Docker for Mac?
### Can I pass through a USB device to a container?
Note that 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
[What to know before you install](install.md#what-to-know-before-you-install) in
the install guide.
### 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
folder](https://support.apple.com/en-us/HT201548) after Docker for Mac is
already installed, you need to uninstall and reinstall Docker for Mac. Otherwise, Docker for Mac will fail to start. See also,
[Docker for Mac will not start if Mac user account and home folder are renamed after installing Docker for Mac](troubleshoot.md#docker-for-mac-will-not-start-if-mac-user-account-and-home-folder-are-renamed-after-installing-the-app) in Troubleshooting.
### Do I need to uninstall Docker Toolbox to use Docker for Mac?
No, you can use these side by side. Docker Toolbox leverages a Docker daemon
installed using `docker-machine` in a machine called `default`. Running `eval
$(docker-machine env default)` in a shell sets DOCKER environment variables
locally to connect to the default machine using Engine from Toolbox. To check
whether Toolbox DOCKER environment variables are set, run `env | grep DOCKER`.
To make the client talk to the Docker for Mac Engine, run the command `unset
${!DOCKER_*}` to unset all DOCKER environment variables in the current shell.
(Now, `env | grep DOCKER` should return no output.) You can have multiple
command line shells open, some set to talk to Engine from Toolbox and others set
to talk to Docker for Mac. The same applies to `docker-compose`.
### How do I uninstall Docker Toolbox?
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
Toolbox on the Mac, see [How to uninstall
Toolbox](/toolbox/toolbox_install_mac.md#how-to-uninstall-toolbox) in the
Toolbox Mac topics.
Unfortunately it is not possible to pass through a USB device (or a
serial port) to a container. For use cases requiring this, we
recommend the use of [Docker Toolbox](/toolbox/overview.md).
## Components of Docker for Mac
### What is HyperKit?
HyperKit is a hypervisor built on top of the Hypervisor.framework in macOS 10.10
@ -315,9 +327,3 @@ tailor made for Docker workloads on the Mac.
The privileged helper process `com.docker.vmnetd` is started by `launchd` and
runs in the background. The process will not consume any resources unless
Docker.app connects to it, so it's safe to ignore.
### Can I pass through a USB device to a container?
Unfortunately it is not possible to pass through a USB device (or a serial
port) to a container. For use cases requiring this, we recommend the use of
[Docker Toolbox](/toolbox/overview.md).