Docker Not Working on macOS? Here’s How to Reset It Like a Pro

A Step-by-Step Guide to Completely Reset Docker on macOS and Fix Common Issues

Docker is a game-changer for developers and tech enthusiasts, allowing seamless containerization of applications. But what happens when Docker suddenly stops working on macOS? Maybe it won’t start, or you keep getting annoying permission errors. Reinstalling doesn’t always fix the issue.

Reset Docker Like a Pro

Before you throw your Mac out the window, there’s a smarter way to reset Docker completely and ensure it runs flawlessly afterward. In this guide, we’ll walk you through a bulletproof reset method while sharing insider troubleshooting tips that most guides overlook. By the end, you won’t just know how to fix Docker; you’ll understand why it breaks and how to prevent it in the future.

Step 1: Stop Docker Like a Pro (Not Just Close It)

Many users think quitting Docker from the macOS menu bar is enough it’s not. Docker runs background processes that need to be stopped manually.

Run these commands to force-stop Docker and remove any lingering processes:

sudo pkill -f docker
sudo launchctl stop com.docker.docker
sudo launchctl remove com.docker.docker

Step 2: Uninstall Docker the Right Way

Deleting the Docker app from Applications isn’t enough. Docker leaves behind configuration files and system data that can interfere with a clean reinstall.

Use these commands to remove Docker completely:

sudo rm -rf /Applications/Docker.app
sudo rm -rf ~/Library/Containers/com.docker.docker
sudo rm -rf ~/.docker
sudo rm -rf ~/Library/Application\ Support/Docker\ Desktop
sudo rm -rf ~/Library/Group\ Containers/group.com.docker
sudo rm -rf ~/Library/Logs/Docker\ Desktop
sudo rm -rf ~/Library/Preferences/com.docker.*

Next, delete the Docker daemon socket:

sudo rm -rf /var/run/docker.sock

This is a crucial step — skipping it could cause conflicts when you reinstall.

Step 3: Reboot Your Mac

After removing Docker, restart your Mac to ensure that all background processes are cleared.

sudo reboot

Why? Mac’s launch services (launchd) may still cache Docker settings. Restarting ensures a fresh start.

Step 4: Reinstall Docker

Download the latest version of **Docker Desktop for Mac** and install it like any other macOS application.

After installation, open Docker Desktop and allow it to complete its setup. This might take a few minutes.

Step 5: Verify That Everything Works

After reinstalling, test Docker with the following commands:

docker --version
docker info
docker run hello-world

f you see the message “Hello from Docker!”, you’ve successfully restored Docker! 🎉

Advanced Troubleshooting (For Those Who Want Extra Insights)

f Docker still isn’t working, try these additional steps:

1. Fix Permission Issues

If you get a “permission denied” error when running docker network ls or docker info, add yourself to the Docker group:

sudo dscl . -append /Groups/docker GroupMembership $USER
newgrp docker

2. Use Colima Instead of Docker Desktop (For Advanced Users)

If Docker Desktop is too heavy or problematic, consider using Colima, a lightweight alternative that runs Docker inside a VM:

brew install colima
colima start

Then, try:

docker ps

Colima is a great Docker Desktop alternative if you want a minimal, efficient setup.

Reset Docker Like a Pro

Fix It Once, Fix It for Good

Resetting Docker properly on macOS isn’t just about reinstalling it’s about removing all traces of previous installations and fixing potential conflicts.

By following this method, you’re not just getting Docker back you’re ensuring it runs smoother than ever. And if you ever run into issues again, you now have insider-level troubleshooting skills to fix them like a pro.

So next time Docker misbehaves, you’ll know exactly what to do without the frustration. 🚀