How to free up Docker disk space on a Mac

Docker Desktop on a Mac stores everything in one large disk image, so it can quietly grow to tens of gigabytes and doesn’t shrink on its own when you delete things.

See what is using the space

docker system df

This lists images, containers, local volumes and build cache, and how much of each is reclaimable. Add -v for a per-item breakdown.

Remove what you don’t use

• Stopped containers, unused networks and dangling images: docker system prune
• All unused images, not just dangling ones: docker system prune -a
• Build cache: docker builder prune
• Unused volumes: docker volume prune

Be careful with the last one. Volumes often hold database data. A volume that no container currently uses may still be the only copy of something you need, so check docker volume ls first. Docker deletes with no Trash and no undo.

Reclaim the space on disk

On some setups the disk image stays the same size after pruning. In Docker Desktop’s Settings → Resources, you can lower the disk image limit, and the Troubleshoot menu has a clean-up option that resets data (which deletes everything, so use it as a last resort).

Local AI containers and models

Model-serving containers can add several gigabytes each. If you run local models directly, see how to delete Ollama and Hugging Face models.

How Gardner handles Docker

Gardner reads docker system df and lists images, build cache and volumes under “Containers and VMs”. Volumes are always marked “your call” and never ticked. Because Docker has no Trash, Gardner labels Docker removals as permanent before you confirm; files it removes elsewhere go to the Trash.