Warum Docker auf dem Mac so viel Platz belegt, und die Lösung

Wo der Platz von Docker wirklich liegt

Docker Desktop führt Container in einer kleinen virtuellen Linux-Maschine aus. Das Laufwerk dieser Maschine ist eine einzige Datei auf deinem Mac, unter ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw.

Die Datei ist eine Sparse-Datei. Der Finder zeigt sie möglicherweise mit ihrer maximal erlaubten Größe an, auch wenn weit weniger belegt ist. Der Befehl unten zeigt beide Werte: Die erste Spalte ist der Platz, der auf deinem Laufwerk wirklich belegt ist, und die Größe weiter hinten in der Zeile ist das Maximum.

Deshalb ist es nicht möglich, die Dateien eines Containers von macOS aus zu löschen, und deshalb sieht der Ordner in jedem Laufwerkswerkzeug wie ein einziges riesiges Objekt aus.

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

Sieh nach, was den Platz belegt

Frag Docker nach einer Aufschlüsselung, während Docker Desktop läuft. Der Befehl unten listet vier Dinge auf: Images, Container, lokale Volumes und Build-Cache, jeweils mit der Gesamtgröße und dem Anteil, der sich zurückholen lässt.

Hänge -v an, um eine Zeile pro Image, Container und Volume zu bekommen. Es lohnt sich, das eine Minute lang zu lesen. Auf den meisten Entwicklerrechnern sind die großen Posten alte Images und Build-Cache, aber wenn Volumes groß sind, sind das Daten, und sie verlangen mehr Sorgfalt.

docker system df

Schritt 1: das sichere Aufräumen

Fang mit dem Befehl unten an. Er entfernt gestoppte Container, Netzwerke, die kein Container nutzt, Dangling Images, also Layer, die kein Tag mehr haben und auf die nichts mehr verweist, und ungenutzten Build-Cache. Docker listet auf, was es entfernen wird, und bittet dich um Bestätigung.

Er entfernt keine Images mit einem Tag, keine laufenden Container und keine Volumes. Vielen reicht das.

Nichts hiervon ist schwer zurückzubekommen. Ein entfernter Container lässt sich aus seinem Image neu anlegen, und fehlender Build-Cache kostet dich nur einen langsameren nächsten Build. Prüfen solltest du nur, ob ein gestoppter Container Dateien enthält, die du in ihm geschrieben und nie herauskopiert hast.

docker system prune

Schritt 2: ungenutzte Images und Build-Cache

Wenn du mehr brauchst, nimm dir gezielt Images und Build-Cache vor.

• docker image prune -a entfernt jedes Image, das kein Container nutzt, ob mit Tag oder ohne. Du lädst oder baust sie erneut, wenn du sie das nächste Mal brauchst.
• docker builder prune entfernt Build-Cache. Hänge -a an, um alles zu entfernen, nicht nur den Dangling-Teil. Deine nächsten Builds starten kalt und dauern länger.
• docker system prune -a erledigt beides zusammen mit dem Aufräumen aus Schritt 1.
• docker container ls -a zeigt gestoppte Container. Einer, den du noch willst, hält vielleicht ein großes Image in Gebrauch.

Schritt 3: Volumes, mit Vorsicht

In Volumes legen Container Daten ab, die überdauern sollen: Datenbankdateien, Uploads, Paket-Caches. Sie aufzuräumen kann echte Arbeit löschen, also sieh erst hin.

Liste sie mit dem ersten Befehl unten auf und prüfe, zu welchen Projekten sie gehören. Der zweite Befehl entfernt anonyme Volumes, die kein Container nutzt. Mit -a gilt das auch für benannte Volumes, die kein Container nutzt, und dort liegt meist eine lokale Entwicklungsdatenbank.

Wenn ein Volume wichtig ist, sichere es oder erstelle einen Dump der Datenbank, bevor du aufräumst. Volumes eines Compose-Projekts lassen sich zusammen mit diesem Projekt entfernen, mit docker compose down -v, ausgeführt im Projektordner.

docker volume ls
docker volume prune

Den Platz auf deinem Mac zurückbekommen

Nach dem Aufräumen gibt Docker Desktop den frei gewordenen Platz im virtuellen Laufwerk an macOS zurück. Beim Format Docker.raw passiert das normalerweise innerhalb von Augenblicken, auch wenn Werkzeuge, die die Maximalgröße der Datei anzeigen, keine Änderung zeigen. Führe den ls-Befehl aus dem ersten Abschnitt erneut aus, um den echten Wert zu sehen.

Damit die Datei künftig nicht so groß wird, öffne Docker Desktop, geh zu „Settings“ (Einstellungen), dann „Resources“, und senke das Limit für die Laufwerksnutzung. Docker warnt dich, wenn die Änderung vorhandene Daten löschen würde.

Wenn du ganz von vorn anfangen willst, hat der Bereich „Troubleshoot“ (Fehlerbehebung) von Docker Desktop die Option „Clean / Purge data“ und ein Zurücksetzen auf die Werkseinstellungen. Beide löschen alle Images, Container und Volumes.

Was nicht in Docker.raw liegt

Ein paar Dinge rund um Docker liegen außerhalb des virtuellen Laufwerks. Ordner, die du in Container einbindest, sind gewöhnliche Ordner auf deinem Mac und werden von keinem prune-Befehl angefasst. Projektordner enthalten ihre eigene Build-Ausgabe, etwa node_modules. Und wenn du Docker Desktop entfernst, bleiben seine Hilfsprogramme, Gruppencontainer und der Ordner ~/.docker zurück, wenn du sie nicht ebenfalls entfernst.

Wo Diskzy ins Spiel kommt

Diskzy zeigt in der Laufwerkskarte, wie groß Docker.raw wirklich ist, damit du weißt, wann es Zeit ist, in Docker aufzuräumen. Es verkleinert die Datei nicht für dich.

Wenn du dich entscheidest, Docker Desktop ganz zu entfernen, entfernt „Uninstall“ (Deinstallieren) in Diskzy die App zusammen mit dem, was sie zurückgelassen hat, einschließlich Containern, Launch Agents und privilegierten Hilfsprogrammen. Alles kommt in den Papierkorb.