From 2277dda1afe3869665b4eefab043e96abe515a9a Mon Sep 17 00:00:00 2001 From: Akim Demaille Date: Fri, 25 May 2018 14:16:16 +0200 Subject: [PATCH] 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 --- docker-for-mac/faqs.md | 21 +++++++++++++++------ docker-for-mac/troubleshoot.md | 9 +-------- 2 files changed, 16 insertions(+), 14 deletions(-) diff --git a/docker-for-mac/faqs.md b/docker-for-mac/faqs.md index ffad40c023..83e4d8b0c8 100644 --- a/docker-for-mac/faqs.md +++ b/docker-for-mac/faqs.md @@ -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? diff --git a/docker-for-mac/troubleshoot.md b/docker-for-mac/troubleshoot.md index 9d755c6878..7c9cdb93bc 100644 --- a/docker-for-mac/troubleshoot.md +++ b/docker-for-mac/troubleshoot.md @@ -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.