keepcalculator

06 Numbers and Powers

Uninstall Docker Mac: Full Removal Guide

Card No. 06·76750 · Updated · Standard formula, shown below

To uninstall Docker Desktop on a Mac, you delete the Docker application, remove its data and configuration files, and clean up related background processes. This guide covers the complete removal process for both the standard Docker Desktop app and the older Docker Toolbox, including how to remove leftover files that can cause issues if you reinstall.

What Docker Desktop Includes on macOS

Docker Desktop for Mac is a full application bundle that includes the Docker Engine, the Docker CLI client, Kubernetes support, and a lightweight Linux virtual machine that runs the containers. When you install it, the installer places the main app in /Applications, but it also creates support files in several hidden directories. The most important are ~/.docker (CLI config and credentials), ~/Library/Containers/com.docker.docker (the VM disk and app data), and ~/Library/Group Containers/group.com.docker (shared settings). There are also preference files, logs, and a socket file that the CLI uses to talk to the daemon.

Simply dragging the app to the Trash does not remove these support files. If you reinstall later, stale configuration or a corrupted VM disk can cause errors like “Docker Desktop is unable to start” or “Cannot connect to the Docker daemon.” A full uninstall removes everything so the next install starts clean.

Before You Uninstall

Uninstalling Docker removes all local images, containers, volumes, and networks. If you have any work you need to keep, export it first:

  • Save images – use docker save -o myimage.tar myimage:tag to export an image to a tar file.
  • Back up volumes – copy the contents of named volumes to a safe location, e.g. docker run --rm -v myvolume:/data -v $(pwd):/backup alpine cp -a /data/. /backup/.
  • Export containers – use docker export -o container.tar container_id to save a container’s filesystem.
  • Note your compose files – docker-compose.yml files are usually in your project directories, not in Docker’s data, so they will survive, but double-check.

If you are using Docker only for local development and have a docker-compose.yml in each project, you likely do not need to back up anything else. The images can be rebuilt from your Dockerfiles.

Step-by-Step Uninstall for Docker Desktop

Docker Desktop includes a built-in uninstaller that removes the app and most of its data. The exact menu path varies slightly by version, but the general steps are:

  1. Quit Docker Desktop: click the Docker menu bar icon (the whale) and choose Quit Docker Desktop.
  2. Open the Docker Desktop app, then go to the menu bar icon again and select Troubleshoot (or Diagnose & Feedback in older versions).
  3. Click Uninstall (or Reset to factory defaults followed by Uninstall). Confirm when prompted.
  4. The uninstaller removes the app, the VM disk, and most support files. It may ask for your macOS password to delete privileged helper files.
  5. After it finishes, check that the Docker menu bar icon is gone. If it is still there, restart your Mac.

If the built-in uninstaller fails or you prefer to do it manually, you can drag Docker.app to the Trash, then delete the following directories and files from your home folder:

  • ~/.docker – CLI config, credentials, and context files
  • ~/Library/Containers/com.docker.docker – VM disk and app data
  • ~/Library/Group Containers/group.com.docker – shared settings
  • ~/Library/Preferences/com.docker.docker.plist – preferences
  • ~/Library/Logs/Docker Desktop – logs
  • ~/Library/Application Scripts/group.com.docker – helper scripts
  • ~/Library/Caches/com.docker.docker – cache files

To see hidden files in Finder, press Command + Shift + . (period). Or use Terminal with ls -la ~ to list them.

Removing Docker Toolbox (Legacy)

Docker Toolbox was the older installer for Macs that could not run Docker Desktop (pre-2010 models or older macOS versions). It used VirtualBox instead of Apple’s HyperKit framework. If you have Toolbox installed, uninstall it separately:

  1. Quit all Docker-related apps and the VirtualBox VM if it is running (docker-machine stop default).
  2. Drag Docker Toolbox.app and VirtualBox.app to the Trash.
  3. Remove the ~/.docker, ~/.docker-machine, and ~/Library/Application Support/Docker Toolbox folders.
  4. Remove the VirtualBox VM files in ~/VirtualBox VMs if you no longer need them.
  5. If you installed the docker, docker-compose, and docker-machine command-line tools via Homebrew, uninstall them with brew uninstall docker docker-compose docker-machine.

Toolbox is no longer supported by Docker, so if you still use it, consider migrating to Docker Desktop or an alternative like Podman or Colima.

What Happens to Your Containers and Images?

All local container data is stored inside the Docker VM disk, which lives in ~/Library/Containers/com.docker.docker/Data/vms. When you uninstall Docker Desktop, that disk is deleted. That means every image you pulled, every container you created, and every volume you wrote to is gone permanently unless you exported it beforehand.

Images that you built from a Dockerfile can be rebuilt by running docker build again. Images pulled from a registry like Docker Hub can be re-pulled. But any data written inside a container’s writable layer or a named volume is lost. This is why the backup step matters if you have database data or generated files you need.

If you only use Docker for stateless development (e.g., running a Node.js or Python environment), you will not lose anything important. If you run databases like PostgreSQL or MySQL in containers, you should export the data first.

Common Problems After Uninstalling

Even after a full uninstall, you may see leftover items:

  • Docker command not found – if you installed the CLI via Homebrew, it is separate from Docker Desktop. Run which docker to see if it still exists. Uninstall it with brew uninstall docker if you want it gone.
  • Menu bar icon persists – restart your Mac. If it still appears, the app may have been running from a different location (e.g., ~/Applications). Search for “Docker.app” in Finder.
  • Socket file remains – the ~/.docker/run/docker.sock file may remain. Deleting the whole ~/.docker folder removes it.
  • VPN or network issues – Docker Desktop installs a VPN component that can sometimes leave network proxy settings behind. Check System Settings > Network > Proxies and remove any Docker-related entries.
  • Disk space not freed – the VM disk can be several gigabytes. If you used the built-in uninstaller, it should delete it. If not, manually delete the com.docker.docker container folder.

If you plan to reinstall Docker Desktop later, a full uninstall avoids most of these issues. If you are switching to a different container runtime, you may want to keep the ~/.docker config folder because it contains registry credentials and context settings that Podman or Colima can reuse.

Alternatives if You Still Need Containers

If you are uninstalling Docker Desktop because of licensing costs or resource usage, several free alternatives work on macOS:

  • Podman – a daemonless container engine that is CLI-compatible with Docker. Install with brew install podman and run podman machine init to create a VM.
  • Colima – a lightweight VM manager that runs Docker containers using Lima. Install with brew install colima docker, then run colima start.
  • OrbStack – a commercial app with a free tier that is faster and lighter than Docker Desktop, but it is not open source.
  • Rancher Desktop – a free, open-source desktop app that bundles Kubernetes and Docker, similar to Docker Desktop.

All of these can run existing docker-compose.yml files with minimal changes. If you only need to run a single container occasionally, you can also use podman or colima without a GUI.

Frequently Asked Questions

Do I need to uninstall Docker if I stop using it? Not strictly, but it is a good idea. Docker Desktop runs background processes and a VM that consume CPU and memory even when idle. Uninstalling frees disk space and removes those background tasks. If you are not using containers, there is no reason to keep it.

Will uninstalling Docker Desktop remove my images? Yes, all local images, containers, and volumes are deleted. If you need them, export them first with docker save or docker export. Images on Docker Hub or another registry are not affected.

Can I reinstall Docker Desktop after uninstalling? Yes, a full uninstall actually makes reinstallation cleaner. Download the latest version from Docker’s website and install it as you did the first time. Your old CLI config in ~/.docker will be recreated if you deleted it.

How do I uninstall Docker without the built-in uninstaller? Drag Docker.app to the Trash, then delete the folders listed in the manual steps above. Finally, empty the Trash and restart your Mac. This works for most versions.

Does uninstalling Docker affect my other development tools? Only if they depend on the Docker CLI or socket. Tools like VS Code’s Docker extension, Jenkins, or scripts that call docker will stop working. They will work again if you install an alternative like Podman and alias the CLI.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →