Guides Levo · Développeurs : tout le reste

Docker utilise trop d’espace disque sur Mac

Sur un Mac, Docker stocke tout dans un seul gros fichier de disque virtuel, Docker.raw, qui grossit mais ne rétrécit pas tout seul. Lancez docker system df pour voir ce qui l’occupe, puis docker system prune et docker builder prune pour le libérer.

La liste Ready to free de Levo avec des images Docker et du cache de compilation, chacun avec une taille et une raison

Quoi	Comment le voir	Suppression sûre ?
Conteneurs arrêtés	`docker ps -a`	Oui, sauf si vous avez besoin de ce qu’ils contiennent
Images inutilisées	`docker images`	Oui, elles sont téléchargées ou reconstruites à la demande
Cache de compilation	`docker builder du`	Oui, la prochaine compilation est plus lente
Volumes	`docker volume ls`	Prudence. Une base de données se trouve ici
Le fichier de disque	`~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw`	Jamais à la main

Pourquoi Docker.raw est si gros

Les conteneurs tournent dans une petite machine virtuelle Linux, et le disque de cette machine est un seul fichier sur votre Mac. Docker Desktop fixe une taille maximale, souvent 60 Go ou plus, et le fichier grossit vers elle à mesure que vous téléchargez des images et compilez. Dans le Finder, il peut sembler bien plus gros qu’il ne l’est, car c’est un fichier creux : ls -lh affiche le maximum, du -sh affiche ce qui est réellement utilisé.

Le piège est que supprimer des images libère de l’espace à l’intérieur de la machine virtuelle, mais le fichier sur votre Mac ne rétrécit pas tout de suite. Les versions récentes de Docker Desktop rendent les blocs libérés à macOS, mais avec des configurations plus anciennes ou après beaucoup d’activité, vous devrez peut-être redimensionner le disque ou le réinitialiser depuis Settings › Resources.

Comment le faire vous-même

Voir ce qui occupe la place

docker system df
docker system df -v

La première commande donne les totaux pour les images, les conteneurs, les volumes et le cache de compilation, avec une colonne RECLAIMABLE. La seconde les liste un par un. Le cache de compilation est le discret : après quelques semaines de compilations, c’est souvent la plus grosse ligne.

Le libérer

docker container prune
docker image prune -a
docker builder prune
docker system prune

docker container prune supprime les conteneurs arrêtés.
docker image prune -a supprime toutes les images qu’aucun conteneur n’utilise, y compris celles qui ont une étiquette. Sans -a, il ne supprime que les images orphelines.
docker builder prune supprime le cache de compilation. Ajoutez --all pour inclure le cache utilisé par les compilations étiquetées.
docker system prune traite d’un coup les conteneurs, les réseaux, les images orphelines et le cache de compilation. Il ne supprime pas les volumes sauf si vous ajoutez --volumes.

Les volumes sont l’endroit où vivent les bases de données, les fichiers envoyés et tout ce que votre fichier compose a monté sur un volume nommé. docker system prune --volumes supprime tous les volumes qu’aucun conteneur n’utilise à cet instant, y compris celui de Postgres du projet que vous ouvrirez la semaine prochaine. Listez-les avec docker volume ls et supprimez-les un par un avec docker volume rm <name> après vérification.

Rendre l’espace à macOS

Après le nettoyage, vérifiez de nouveau la taille réelle.

du -sh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw

S’il reste énorme, ouvrez Docker Desktop, allez dans Settings › Resources et abaissez Virtual disk limit, ou choisissez Troubleshoot › Clean / Purge data pour repartir de zéro. La seconde option supprime toutes vos images, tous vos conteneurs et tous vos volumes. Ne glissez pas Docker.raw dans la corbeille pendant que Docker tourne : vous perdez tout ce qu’il contient et pouvez corrompre la machine virtuelle.

OrbStack, Colima et Podman

Les mêmes commandes fonctionnent, car tous parlent l’API Docker. Ce qui diffère, c’est l’endroit où se trouve le disque.

OrbStack réduit son disque automatiquement et utilise l’espace à la demande. Ses données sont dans ~/.orbstack. Consultez les Settings de l’app, et utilisez docker system df comme ci-dessus.
Colima garde son disque sous ~/.colima. La taille est fixée quand vous créez l’instance avec colima start --disk 100. colima delete supprime toute la machine virtuelle.
Podman utilise podman system df et podman system prune, avec son image de machine sous ~/.local/share/containers/podman/machine.

Si vous n’utilisez plus Docker du tout, consultez comment désinstaller Docker sur Mac. Pour un regard plus large sur le reste de votre chaîne d’outils, il y a le nettoyage du disque d’un Mac de développeur.

Comment Levo s’y prend

Levo liste les images Docker et le cache de compilation comme des types à part dans Ready to free, avec tailles et raisons. Il les trouve grâce à son index en direct de votre disque : vous les voyez donc sans lancer de commande, et sans avoir à retenir laquelle des quatre commandes prune utiliser.

Votre agent juge ce qui est sûr. Les images que rien n’utilise et le cache de compilation sont des candidats ordinaires. Les volumes peuvent contenir des données irrécupérables : regardez-les vous-même, et Levo ne nettoie jamais rien qui soit en cours d’utilisation. L’agent ne fait que lire, et Levo supprime après avoir revérifié.

Vous choisissez un niveau de nettoyage, cochez ce qui part et cliquez sur Clean up. Si vous désinstallez Docker Desktop avec Levo, l’étape de confirmation liste ses gros restes pour que vous les voyiez avant qu’ils partent. Consultez Levo pour les développeurs web. Deux nettoyages sont gratuits, puis il y a une licence à vie.

FAQ

Peut-on lancer docker system prune sans risque ?

Oui pour les conteneurs, les réseaux, les images orphelines et le cache de compilation, mais la prochaine compilation sera plus lente et certaines images seront retéléchargées. Il laisse les volumes tranquilles sauf si vous ajoutez --volumes, l’option dont il faut se méfier.

Pourquoi Docker.raw est-il encore énorme après avoir supprimé des images ?

Le fichier est creux et ne rétrécit pas toujours quand de l’espace est libéré dans la machine virtuelle. Vérifiez la taille réelle avec du -sh. S’il est toujours gros, abaissez la limite du disque virtuel dans les réglages Resources de Docker Desktop ou purgez ses données.

Puis-je supprimer Docker.raw ?

Seulement via le menu Troubleshoot de Docker Desktop, Docker étant lancé, ou après l’avoir quitté et désinstallé. Supprimer le fichier à la main supprime toutes les images, tous les conteneurs et tous les volumes qu’il contient.

De combien d’espace Docker a-t-il besoin sur Mac ?

Cela dépend de ce que vous exécutez. Prévoyez de 20 à 60 Go si vous construisez beaucoup d’images. La limite du disque virtuel dans Docker Desktop fixe le plafond.

OrbStack utilise-t-il moins de disque que Docker Desktop ?

En général, car il grossit et rétrécit à la demande et partage des fichiers avec macOS. Il garde quand même des images, du cache de compilation et des volumes : docker system df et prune s’y appliquent donc aussi.