Issues with MacOS Docker Desktop after changing your username

After changing your MacOS username, you might encounter issues with Docker Desktop not starting properly. This is often due to Docker’s internal paths still referencing the old username. The “Docker Desktop encountered an unexpected error and needs to close” message when starting Docker Desktop may reference the old path, and a “permission denied” error. For example: running engine: waiting for the VM setup to be ready: preparing VM: creating disk folder /Users/{old_username}/Library/Containers/com.docker.docker/Data/vms/0/data: mkdir /Users/{old_username}: permission denied On MacOS, you need to edit the ~/Library/Group\ Containers/group.com.docker/settings-store.json file to update the paths - in my case it was the DataFolder path that needed updating. ...

December 16, 2025 · 1 min · 146 words · Sammy Fox