Por qué Docker ocupa tanto espacio en Mac y cómo arreglarlo

Dónde está realmente el espacio de Docker

Docker Desktop ejecuta los contenedores dentro de una pequeña máquina virtual Linux. El disco de esa máquina es un único archivo en tu Mac, en ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw.

El archivo es disperso (sparse). El Finder puede mostrarlo con su tamaño máximo permitido aunque se esté usando mucho menos. El comando de abajo muestra las dos cifras: la primera columna es el espacio que ocupa de verdad en tu disco, y el tamaño que aparece más adelante en la línea es el máximo.

Por eso no es posible borrar los archivos de un contenedor desde macOS, y por eso la carpeta parece un único ítem enorme en cualquier herramienta de disco.

ls -klsh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw

Ver qué está ocupando el espacio

Con Docker Desktop en ejecución, pídele a Docker un desglose. El comando de abajo muestra cuatro cosas: imágenes, contenedores, volúmenes locales y caché de compilación, con el tamaño total de cada una y cuánto se puede recuperar.

Añade -v para ver una línea por imagen, contenedor y volumen. Merece la pena dedicar un minuto a leerlo. En la mayoría de los equipos de desarrollo lo grande son las imágenes antiguas y la caché de compilación, pero si los volúmenes son grandes, eso son datos, y requiere más cuidado.

docker system df

Paso 1: la limpieza segura

Empieza por el comando de abajo. Elimina los contenedores detenidos, las redes que no usa ningún contenedor, las imágenes huérfanas (dangling), que son capas que ya no tienen etiqueta ni referencia, y la caché de compilación sin usar. Docker muestra lo que va a eliminar y te pide confirmación.

No elimina las imágenes que tienen etiqueta, los contenedores en ejecución ni los volúmenes. A mucha gente le basta con esto.

Nada de esto es difícil de recuperar. Un contenedor eliminado se puede volver a crear a partir de su imagen, y la caché de compilación solo te cuesta una siguiente compilación más lenta. Lo único que hay que comprobar es si un contenedor detenido contiene archivos que escribiste dentro y nunca copiaste fuera.

docker system prune

Paso 2: imágenes sin usar y caché de compilación

Si necesitas más, ve específicamente a por las imágenes y la caché de compilación.

• docker image prune -a elimina todas las imágenes que no usa ningún contenedor, tengan etiqueta o no. Las descargarás o compilarás de nuevo la próxima vez que las necesites.
• docker builder prune elimina la caché de compilación. Añade -a para eliminarla toda, no solo la parte huérfana. Tus siguientes compilaciones empiezan de cero y tardan más.
• docker system prune -a hace las dos cosas anteriores junto con la limpieza del paso 1.
• docker container ls -a muestra los contenedores detenidos. Uno que todavía quieras puede estar manteniendo en uso una imagen grande.

Paso 3: volúmenes, con cuidado

Los volúmenes son donde los contenedores guardan los datos que deben sobrevivir: archivos de bases de datos, archivos subidos, cachés de paquetes. Limpiarlos puede borrar trabajo real, así que mira antes.

Lístalos con el primer comando de abajo y comprueba a qué proyectos pertenecen. El segundo comando elimina los volúmenes anónimos que no usa ningún contenedor. Añadir -a lo amplía a los volúmenes con nombre que no usa ningún contenedor, que es donde suele vivir una base de datos de desarrollo local.

Si un volumen es importante, haz una copia de seguridad o vuelca la base de datos antes de limpiar. Los volúmenes de un proyecto de Compose se pueden eliminar junto con ese proyecto usando docker compose down -v, ejecutado en la carpeta del proyecto.

docker volume ls
docker volume prune

Recuperar el espacio en tu Mac

Después de limpiar, Docker Desktop devuelve a macOS el espacio liberado dentro del disco virtual. Con el formato Docker.raw esto suele ocurrir en unos instantes, aunque las herramientas que muestran el tamaño máximo del archivo no mostrarán ningún cambio. Ejecuta otra vez el comando ls de la primera sección para ver la cifra real.

Para que no crezca tanto en el futuro, abre Docker Desktop, ve a Settings, después a Resources, y reduce el límite de uso de disco. Docker te avisa si el cambio va a borrar datos existentes.

Si quieres empezar de cero por completo, la pantalla Troubleshoot de Docker Desktop tiene una opción Clean / Purge data y un restablecimiento a los valores de fábrica. Ambas borran todas las imágenes, contenedores y volúmenes.

Qué no está dentro de Docker.raw

Algunas cosas relacionadas con Docker están fuera del disco virtual. Las carpetas que montas en los contenedores son carpetas normales de tu Mac y ninguna limpieza las toca. Las carpetas de los proyectos tienen su propio resultado de compilación, como node_modules. Y si eliminas Docker Desktop, sus herramientas auxiliares, sus contenedores de grupo y la carpeta ~/.docker se quedan en el disco salvo que los elimines también.

Dónde encaja Diskzy

Diskzy muestra en el mapa del disco cuánto ocupa realmente Docker.raw, para que sepas cuándo toca limpiar desde dentro de Docker. No reduce el archivo por ti.

Si decides eliminar Docker Desktop del todo, la pestaña Uninstall (Desinstalar) de Diskzy elimina la app junto con lo que dejó, incluidos los contenedores, los agentes de inicio y las herramientas auxiliares con privilegios. Todo va a la Papelera.