Fixing a Frozen Docker Desktop and Reclaiming macOS Build Cache

Even Docker needs a bit of TLC sometimes — Tender Love and Care.
Mine had been through too many builds, abandoned containers, and half-finished experiments.
One day, docker builder prune -af just… never ended. Then docker info froze. My Mac sounded like a jet.

If your Docker Desktop ever behaves like an overworked pet — refusing to prune, restarting endlessly, or hoarding gigabytes of build cache — don’t panic.
Here’s how I nursed mine back to health, step by step, and how you can too.

My setup, for context: an Apple Silicon MacBook Pro running a recent Docker Desktop release. The command that stalled was docker builder prune -af; docker info stopped responding a few minutes after.

🔎 Docker Desktop Symptoms: Frozen docker info, Stalled Prune, and Disk Warnings

None of these “quick fixes” are guaranteed diagnoses — a hanging docker info doesn’t prove the backend crashed, and “Starting…” doesn’t prove disk corruption. Treat this table as a starting point for investigation, not a lookup table for causes.

Symptom	What to check	Next step
docker builder prune -af never ends	Is the engine responding at all (docker info)?	Restart Docker Desktop, then retry the prune
docker info hangs	Engine status in the Docker Desktop UI	Restart Docker Desktop — a hang alone doesn’t confirm the backend crashed
Docker Desktop stuck on “Starting…”	How long it’s been stuck; free disk space (df -h /)	Restart Docker Desktop first; treat the VM disk as a last resort (see below)
Disk space shrinking mysteriously	docker system df -v and docker buildx du	Prune build cache — it’s usually the largest reclaimable share
Builds suddenly slower	Whether cache was recently pruned; selected builder (docker buildx ls)	Expected for the first build or two after a prune
Containers stop randomly	VM disk headroom, in Settings → Resources	Free disk space or increase the VM disk size

---

Why Docker Desktop freezes, the fix checklist and the cache cleanup commands follow below.

🧠 Why Docker Desktop Freezes on macOS

🔒 Subscribe to keep reading.

🧩 Docker Desktop Fix Checklist

🔒 Subscribe to keep reading.

🧯 Last Resort: Replacing the Docker Desktop VM Disk (Docker.raw)

🔒 Subscribe to keep reading.

🧮 Interpreting docker system df -v Output

🔒 Subscribe to keep reading.

⚙️ Automating Docker Build Cache Cleanup with a Scheduled Script

🔒 Subscribe to keep reading.

🧱 Is docker system prune -f Safe on a Running Docker Compose Stack?

🔒 Subscribe to keep reading.

🧩 Docker Compose Command Reference

🔒 Subscribe to keep reading.

🔧 Docker CLI Command Reference Table

🔒 Subscribe to keep reading.

🌿 Preventing Docker Desktop Cache and Disk Issues

🔒 Subscribe to keep reading.

💬 Key Takeaway: Docker Desktop Cache Hygiene Prevents Freezes

🔒 Subscribe to keep reading.

References

🔒 Subscribe to keep reading.