Désinstaller Docker Desktop sans perdre un volume

Docker Desktop n'est pas une seule application. C'est une interface graphique, une machine virtuelle en arrière-plan, un ensemble d'outils en ligne de commande liés symboliquement dans /usr/local/bin, et une image disque qui grossit discrètement jusqu'à des dizaines de gigaoctets. Le déplacer vers la Corbeille ne retire que le premier élément et laisse le reste.

C'est aussi l'inverse de la plupart des désinstallations : lancer le programme de désinstallation officiel est l'étape destructrice, pas le nettoyage qui suit. Voici l'ordre qui préserve vos données, et comment distinguer les restes jetables de ceux que vous voudrez récupérer.

La désinstallation détruit vos conteneurs, images et volumes

Docker le dit clairement : désinstaller Docker Desktop détruit les conteneurs, les images, les volumes et les autres données Docker présentes sur la machine. Il n'y a ni retour en arrière ni passage par la Corbeille. Aucun second avertissement ne s'affiche.

La plus grande partie est reconstruisible. Les images se retéléchargent, les conteneurs se reconstruisent à partir d'un Dockerfile. L'exception, ce sont les volumes nommés, là où une base de données locale conserve ses données. Un conteneur Postgres ou MySQL sur lequel vous développez depuis des mois stocke ses lignes dans un volume, pas dans l'image, et ce volume est supprimé avec tout le reste.

Avant toute chose, listez ce qui existe :

docker volume ls

Si un volume est important, sauvegardez-le avant la désinstallation, pas après :

docker run --rm -v <volume>:/from -v "$PWD":/to alpine \
  tar czf /to/<volume>.tgz -C /from .

La même règle s'applique à tout ce que vous avez construit sans jamais le publier. docker image ls montre ce qui est local ; s'il n'est pas dans un registre, il n'existe que sur ce Mac.

Si c'est l'espace disque qui vous motive, vous n'avez peut-être pas besoin de désinstaller

Docker regroupe tout dans une seule grande image de disque virtuel, et ce fichier est en général le plus volumineux de tout l'ensemble Docker. Un nettoyage à l'intérieur de Docker libère souvent l'espace recherché tout en laissant l'outil installé, et le tout reste réversible. Commencez par docker system df pour voir la répartition, puis lisez Nettoyer Docker sur Mac sans perdre de données, qui couvre le pruning et la raison pour laquelle le fichier disque ne se réduit pas de lui-même.

Si votre but est de retirer Docker définitivement, continuez.

Utilisez le programme de désinstallation de Docker

Docker fournit un programme de désinstallation et il fait plus que supprimer le paquet. Il décharge les services d'arrière-plan et retire les liens symboliques des outils en ligne de commande qu'un glisser-déposer dans le Finder laisse derrière lui.

Depuis l'application : ouvrez Docker Desktop, sélectionnez l'icône Troubleshoot en haut à droite, choisissez Uninstall, et confirmez. Depuis le Terminal :

/Applications/Docker.app/Contents/MacOS/uninstall

Puis déplacez Docker des Applications vers la Corbeille.

Si le programme de désinstallation affiche operation not permitted, la documentation Docker indique que ce message peut être ignoré sans risque : la désinstallation s'est tout de même terminée. Le message vient de macOS qui protège le dossier conteneur de l'application, que votre Terminal ne peut pas modifier sans l'Accès disque complet.

Ce qui reste, et à quoi cela correspond

Après l'exécution du programme de désinstallation, certains dossiers demeurent. Docker en nomme deux :

~/Library/Group Containers/group.com.docker
~/.docker

Ce n'est pas la même chose, et toute la différence est là.

~/.docker est votre configuration. Il contient les contextes, les réglages du démon et les identifiants de registre issus de docker login. Si vous réinstallez Docker plus tard, ou passez à Colima, Rancher Desktop ou OrbStack, c'est le dossier que vous voudrez peut-être garder. Le supprimer signifie se reconnecter à chaque registre.

~/Library/Group Containers/group.com.docker et le dossier conteneur de l'application contiennent l'état de la machine virtuelle et l'image disque. C'est là que se trouvent les dizaines de gigaoctets. Une fois que vous avez accepté que les conteneurs et les volumes sont partis, c'est la partie qu'il vaut la peine de retirer.

Au-delà de ces deux éléments, Docker laisse les traces habituelles d'une application macOS : caches, journaux, préférences et état d'application sauvegardé sous votre Bibliothèque. Ceux-là sont jetables. L'objectif n'est pas de supprimer chaque fichier portant docker dans le nom, mais de savoir lequel est un cache et lequel est un identifiant.

Vérifiez qu'il a bien disparu

Deux vérifications. D'abord, que plus rien ne tourne :

pgrep -fl -i docker

Ensuite, que les outils en ligne de commande ont bien été retirés :

which docker docker-compose

Les deux ne doivent rien renvoyer. Si la commande docker est encore trouvée, vous avez probablement une copie Homebrew de la CLI installée à part, un paquet différent qui reste volontairement en place après le programme de désinstallation de Docker Desktop. brew list | grep docker vous le dira.

La façon la plus rapide de tout voir d'un coup

La voie manuelle fonctionne, mais elle exige que vous sachiez déjà quels chemins existent et lequel contient vos données. C'est la partie que les guides omettent en général, et c'est celle qui vous fait payer cher quand elle tourne mal.

Mole liste chaque fichier qu'une application laisse derrière elle avant toute suppression, regroupés pour que vous voyiez la nature réelle de chaque dossier, avec sa taille à côté. Vous passez l'ensemble en revue, décochez ce que vous voulez garder, et ce que vous retirez va dans la Corbeille plutôt que de disparaître. Pour Docker en particulier, l'image disque représente en général presque tout l'espace récupéré, et voir ce chiffre avant de valider fait la différence entre un nettoyage et une mauvaise surprise.

Ce qui revient après une réinstallation

Les images et les conteneurs reviennent, car ils étaient reproductibles dès le départ : les images se téléchargent à nouveau, les conteneurs se reconstruisent à partir d'un Dockerfile. Les volumes nommés, non. Ce sont les seuls éléments sans copie ailleurs, d'où l'intérêt de l'étape de sauvegarde vue plus haut.

Conservez ~/.docker : vos connexions aux registres et vos contextes reviennent avec lui, ce qui vous évite de refaire un docker login. Supprimez-le et vous devrez vous reconnecter, ce qui ne coûte que du temps.

L'image de disque virtuel est recréée vide. Elle grossit à nouveau à mesure que vous téléchargez des images, si bien que les dizaines de gigaoctets récupérés par une désinstallation sont pour l'essentiel temporaires si vous réinstallez et reprenez une utilisation normale. Pour limiter ce volume sur le long terme, c'est docker system prune qu'il faut, pas un cycle de réinstallation.