Vous consultez l'espace de stockage de votre Mac car votre disque SSD interne arrive à saturation, et vous découvrez un fichier volumineux dissimulé nommé Docker.raw accaparant 60 Go, 90 Go ou même 120 Go de données. Vous ouvrez le Terminal, lancez docker system prune -a --volumes, Docker confirme avoir libéré 40 Go de données, mais dans le Finder, pas le moindre mégaoctet n'a été rendu à votre Mac.

Cette situation constitue l'une des incompréhensions les plus fréquentes pour les développeurs et professionnels travaillant sur macOS. La bonne nouvelle est que votre disque n'est pas bloqué définitivement. Dès lors que l'on comprend les interactions entre macOS et la machine virtuelle Linux de Docker, quelques minutes suffisent pour récupérer l'intégralité de cet espace gaspillé.

Architecture : pourquoi Docker a besoin d'un fichier géant sur Mac

Pour comprendre la taille démesurée prise par Docker.raw, il convient d'examiner le fonctionnement des conteneurs sur l'écosystème Apple.

Les conteneurs reposent sur des fonctions natives du noyau Linux telles que les namespaces, les groupes de contrôle (cgroups) et les systèmes de fichiers superposés (overlayfs). Le noyau de macOS (Darwin) ne possède pas ces fonctionnalités. Par conséquent, macOS ne peut pas exécuter directement un conteneur Linux comme le ferait un serveur Ubuntu ou Debian.

Pour contourner cette limite, Docker Desktop exécute en arrière-plan une machine virtuelle Linux via le framework de virtualisation d'Apple.

Chaque action quotidienne dans vos environnements de développement :

• Téléchargement d'images de bases de données (PostgreSQL, MySQL, Redis)
• Compilation de Dockerfiles complexes avec de multiples dépendances
• Écriture de données dans des volumes Docker persistants
• Mise en cache de couches intermédiaires par BuildKit

Toutes ces données sont stockées à l'intérieur du fichier Docker.raw.

Le piège du fichier creux : pourquoi docker system prune ne libère rien

Face à un disque saturé, le premier réflexe de tout développeur consiste à taper la commande classique dans le Terminal :

docker system prune -a --volumes
Total reclaimed space: 48.62GB

Docker indique fièrement avoir récupéré près de 50 Go. Pourtant, l'espace disponible de votre Mac reste strictement identique. Pour quelle raison ?

La raison réside dans la nature même du fichier Docker.raw, structuré comme un fichier creux APFS (sparse file). Il se comporte comme un ballon doté d'une valve unidirectionnelle :

1. Extension automatique : Lorsque Linux a besoin de 20 Go supplémentaires pour installer des images, macOS alloue des blocs physiques sur votre SSD. Le fichier passe instantanément de 10 Go à 30 Go.
2. Libération interne uniquement : Lorsque vous exécutez docker system prune, le système de fichiers Linux ext4 marque ces blocs internes comme libres. Pour la machine virtuelle, la place est redevenue vacante.
3. Fichier hôte rigide : Depuis macOS, le système voit simplement un fichier binaire continu de 30 Go. Faute d'un signal explicite de compactage (TRIM ou perforation de trous creux APFS), macOS ignore quels blocs sont vides et conserve leur réservation sur le SSD.

Sans action ciblée, Docker.raw conserve indéfiniment son volume maximal atteint dans le passé.

Où se cache le fichier Docker.raw sur votre Mac

Sur les versions contemporaines de macOS, ce fichier se dissimule au cœur de votre dossier Bibliothèque utilisateur :

Vous pouvez vérifier l'espace physique réellement réservé sur votre disque SSD à l'aide de la commande du dans le Terminal :

# Espace physique réellement occupé sur le SSD du Mac :
du -sh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw
Taille virtuelle maximale allouée au fichier :
ls -lh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw

Si le résultat de du -sh indique 75 Go, ce sont très exactement 75 Go de votre disque physique qui restent bloqués, même si aucun conteneur n'est actif au moment où vous lisez ces lignes.

4 méthodes éprouvées pour réduire le volume de Docker.raw

Selon que vous souhaitiez préserver vos images en cours d'utilisation ou repartir d'une installation propre, quatre démarches s'offrent à vous :

Méthode 1 : Récupérer l'espace via l'interface graphique de Docker Desktop

Les éditions récentes de Docker Desktop intègrent un mécanisme officiel permettant d'envoyer l'instruction de compactage à macOS :

1. Lancez l'application Docker Desktop sur votre Mac.
2. Cliquez sur l'icône d'engrenage en haut à droite (Réglages).
3. Accédez au menu Resources > Advanced (ou Virtual disk limit selon la version).
4. Repérez le bouton Reclaim disk space situé sous la jauge de taille du disque virtuel.
5. Cliquez sur ce bouton pour enclencher le processus de compactage.

Docker met la machine virtuelle en pause quelques instants, analyse le fichier creux pour localiser les blocs libérés et restitue ces derniers à macOS. Cette opération s'exécute généralement en une à trois minutes.

Méthode 2 : Vider les caches BuildKit et les images orphelines

Lorsque vous compilez fréquemment vos propres conteneurs, le moteur BuildKit accumule des dizaines de gigaoctets de couches intermédiaires qui échappent aux commandes de nettoyage basiques. Voici comment purger ce cache :

# Purger tous les caches de compilation BuildKit :
docker builder prune -a --force
Supprimer l'ensemble des images locales orphelines :
docker image prune -a --force

Une fois ces commandes validées, retournez dans Docker Desktop et cliquez à nouveau sur Reclaim disk space. Cette simple action libère fréquemment entre 20 Go et 50 Go d'un seul coup.

Méthode 3 : Réinitialiser Docker à zéro (Le redémarrage propre)

Lorsque le fichier Docker.raw souffre d'une forte fragmentation interne, le compactage peut se révéler insuffisant. Une réinitialisation complète offre le résultat le plus radical :

1. Dans la barre supérieure de Docker Desktop, cliquez sur l'icône d'insecte (Troubleshoot).
2. Sélectionnez l'option Clean / Purge data.
3. Cochez les cases Virtual disk et Build cache.
4. Confirmez en cliquant sur le bouton Delete.

Vous pouvez également obtenir ce résultat manuellement : quittez complètement Docker Desktop, puis glissez le fichier ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw dans la Corbeille de macOS. Au prochain lancement de Docker, l'application générera automatiquement un fichier neuf d'environ 2 Go. Les fichiers de code source de vos projets sur votre Mac ne subissent aucune altération.

Méthode 4 : Traquer l'encombrement général de développement avec DiskCompanion

Docker n'est que rarement le seul responsable de la saturation d'un Mac de développeur. De nombreux autres outils accumulent discrètement des gigaoctets inutiles :

Plutôt que d'exécuter des scripts complexes à l'aveugle, l'explorateur visuel de DiskCompanion met en lumière ces zones d'accumulation grâce à une carte interactive. Vous pouvez ainsi récupérer 50 Go à 100 Go d'espace en toute clarté.

Comment empêcher Docker de saturer votre SSD à l'avenir

Quelques réglages préventifs évitent que le fichier Docker.raw ne grossisse à nouveau de manière démesurée :

1. Ajuster la limite de disque virtuel : Dans Docker Desktop, rendez-vous dans Settings > Resources > Virtual disk limit. Par défaut, cette valeur est souvent positionnée sur 64 Go ou 128 Go. Sur un Mac équipé d'un SSD de 256 Go ou 512 Go, baissez cette jauge à 24 Go ou 32 Go. Cela borne la taille maximale et prévient toute saturation imprévue.
2. Activer VirtioFS et la virtualisation native : Dans Settings > General, veillez à cocher « Use Virtualization framework ». Dans Settings > Resources > File sharing, activez le pilote VirtioFS. Ce moteur moderne fourni par Apple offre une meilleure gestion mémoire que les anciennes couches logicielles.
3. Planifier une maintenance périodique : Prenez le réflexe d'exécuter un nettoyage mensuel avec docker builder prune -f ou via un alias dans votre profil de terminal.

Si votre Mac affiche déjà des alertes urgentes de saturation de disque, consultez notre tutoriel dédié pour résoudre un disque de démarrage Mac saturé.

Comparatif des démarches de nettoyage Docker

Voici une synthèse pratique des quatre méthodes, comparant le volume de récupération, la sécurité des données et le temps requis :

Maîtrisez votre espace de développement avec DiskCompanion

En tant que développeur, votre temps de concentration est précieux. Passer des heures à chercher l'origine d'un disque saturé ou lancer des commandes risquées interrompt votre productivité.

DiskCompanion a été pensé pour les utilisateurs de Mac exigeants qui recherchent rapidité, transparence et ergonomie soignée. Conçu en SwiftUI natif, il vous offre une lisibilité totale sur votre SSD sans aucun processus de fond, sans traceurs et sans abonnement récurrent.

Avant de louer des forfaits de stockage en ligne onéreux, faites le point sur vos besoins réels avec notre calculateur de stockage Mac et notre calculateur de mémoire vive RAM Mac gratuits.