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:tagto 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_idto save a container’s filesystem. - Note your compose files –
docker-compose.ymlfiles 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:
- Quit Docker Desktop: click the Docker menu bar icon (the whale) and choose Quit Docker Desktop.
- Open the Docker Desktop app, then go to the menu bar icon again and select Troubleshoot (or Diagnose & Feedback in older versions).
- Click Uninstall (or Reset to factory defaults followed by Uninstall). Confirm when prompted.
- The uninstaller removes the app, the VM disk, and most support files. It may ask for your macOS password to delete privileged helper files.
- 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:
- Quit all Docker-related apps and the VirtualBox VM if it is running (
docker-machine stop default). - Drag
Docker Toolbox.appandVirtualBox.appto the Trash. - Remove the
~/.docker,~/.docker-machine, and~/Library/Application Support/Docker Toolboxfolders. - Remove the VirtualBox VM files in
~/VirtualBox VMsif you no longer need them. - If you installed the
docker,docker-compose, anddocker-machinecommand-line tools via Homebrew, uninstall them withbrew 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 dockerto see if it still exists. Uninstall it withbrew uninstall dockerif 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.sockfile may remain. Deleting the whole~/.dockerfolder 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.dockercontainer 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 podmanand runpodman machine initto create a VM. - Colima – a lightweight VM manager that runs Docker containers using Lima. Install with
brew install colima docker, then runcolima 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
- Infinity Essence in Sailor Piece: Farming and Uses
- Apollo.io Alternatives for Sales Prospecting
- Deploy AI Agents in a Service Desk With Human Oversight
- AIM and Yahoo Profiles: When Did You Last Look?
- Best Smartwatch Under ₹5,000 in India: What to Buy
- Chat History vs Saved Memory in AI Assistants