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

Mac: update instructions for HOME changes 

There's no need to document this in both Troubleshoot and FAQ.  Keep
it in the FAQ.  We don't need to reinstall Docker for Mac, and it's
possible to save all the data.

Signed-off-by: Akim Demaille <akim.demaille@docker.com>
This commit is contained in:
Akim Demaille 2018-05-25 14:16:16 +02:00 committed by Joao Fernandes
parent f68dc07ae5
commit 2277dda1af
2 changed files with 16 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -74,8 +74,8 @@ Do the following each time:
### What is Docker.app?
`Docker.app` is Docker for Mac, a bundle of Docker client, and Docker Engine.
`Docker.app` uses the macOS Hypervisor.framework to run containers, meaning that _**no separate VirtualBox is
required**_.
`Docker.app` uses the macOS Hypervisor.framework to run containers, meaning that
_**no separate VirtualBox is required**_.
### What are system requirements for Docker for Mac?
@ -86,10 +86,19 @@ 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){: 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,
[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.
Starting with Docker for Mac Edge 18.06, this path is relative to the user's
home directory, so it should never be a problem. The remainder of this section
is about older releases of Docker for Mac.
If, after installing Docker for Mac, you [change the name of your macOS user
account and home folder](https://support.apple.com/en-us/HT201548), Docker for
Mac fails to start. [Reset to Factory Defaults](index.md#reset) is the simplest
fix, but you'll lost all your settings, containers, images, etc.
To preserve them, open the `~/Library/Group
Containers/group.com.docker/settings.json` file, and update the `distPath`
entry.
### Do I need to uninstall Docker Toolbox to use Docker for Mac?

9
docker-for-mac/troubleshoot.md
View File

@ -113,14 +113,7 @@ the Getting Started topic.
### Docker for Mac does not start if Mac user account and home folder are renamed after installing the app
If, after installing Docker for Mac, you [change the name of your macOS user
account and home folder](https://support.apple.com/en-us/HT201548), Docker for
Mac fails to start. To solve this problem, uninstall and reinstall Docker for
Mac under the new user account.
See also, the discussion on the issue
[docker/for-mac#1209](https://github.com/docker/for-mac/issues/1209) and [Do I
need to reinstall Docker for Mac if I change the name of my macOS
See [Do I need to reinstall Docker for Mac if I change the name of my macOS
account?](faqs.md#do-i-need-to-reinstall-docker-for-mac-if-i-change-the-name-of-my-macos-account)
in the FAQs.