Docker ocupa demasiado espacio en Mac: cómo recuperarlo

Por qué Docker parece tan grande

Docker Desktop ejecuta los contenedores Linux en una máquina virtual ligera y guarda imágenes, capas, caché de build y volúmenes dentro de una imagen de disco virtual, normalmente Docker.raw. Su capacidad máxima, su tamaño aparente y el espacio que usa de verdad pueden no coincidir. Borrar ese archivo se salta las protecciones de Docker y puede destruir a la vez imágenes, contenedores y volúmenes; moverlo en el Finder puede romper Docker Desktop.

Audita antes de podar

Con Docker Desktop abierto, ejecuta docker system df -v en Terminal: desglosa el uso por categorías, y docker ps -a, docker image ls y docker volume ls muestran qué hay y a qué proyecto pertenece. Que algo figure como «reclaimable» no significa que sea seguro borrarlo: una imagen puede estar compartida, y un volumen sin contenedor conectado puede guardar la única copia de una base de datos.

1. Guarda la salida de docker system df -v con la fecha.
2. Relaciona contenedores, imágenes y volúmenes con proyectos activos.
3. Haz copia de seguridad de cualquier volumen que contenga datos importantes.
4. Poda primero la categoría concreta que explica el crecimiento.
5. Repite la medición y prueba los proyectos antes de hacer más cambios.

Un volumen sin contenedor conectado no es necesariamente desechable: los proyectos de Compose, las bases de datos detenidas y las recuperaciones puntuales suelen dejar volúmenes legítimos sin conectar.

Usa comandos específicos

Elimina los contenedores o imágenes que sepas obsoletos con docker container rm y docker image rm; borrar un contenedor detenido descarta su capa de escritura, pero no los volúmenes con nombre. docker builder prune limpia la caché de build, que es reproducible, aunque la próxima construcción de imágenes tardará más. docker system prune combina categorías: por defecto quita contenedores detenidos, redes sin uso, imágenes huérfanas (dangling) y caché de build sin uso; -a lo amplía a todas las imágenes que no use ningún contenedor y --volumes añade los volúmenes anónimos, así que no añadas esas opciones sin revisar.

Protege volúmenes y el disco virtual

Haz copia de seguridad de las bases de datos con su exportación nativa o con un procedimiento probado: copiar la carpeta de un volumen en uso no garantiza una copia coherente. Cambia el límite o la ubicación del disco desde Docker Desktop Settings, nunca arrastrando Docker.raw en el Finder, y vuelve a medir tras podar, porque el Mac puede tardar en recuperar el espacio. AskClean muestra la huella de Docker en el Mac, pero deja Docker.raw, las credenciales y los datos gestionados por Docker fuera de la limpieza automática.

Resumen de decisiones y riesgos

Audita el uso de disco de Docker Desktop en el Mac, poda contenedores, imágenes y caché de build sin riesgo y protege los volúmenes y el disco Docker.raw.

Preguntas frecuentes