Zum Inhalt springen
SONOYA.com
Selfhosting & Web

Docker belegt zu viel Speicher: sicher aufräumen

Docker füllt die Platte? So findest Du mit docker system df die Ursache, räumst Images und Build-Cache sicher auf und begrenzt wachsende Container-Logs.

Von

Docker-Wal mit Containerstapel als helles Linien-Icon auf dunkelgrünem Verlauf als Sinnbild für einen Server, auf dem Images, Build-Cache und Logs aufgeräumt werden

Auf einem Server, auf dem seit ein paar Monaten Docker läuft, ist die Platte plötzlich zu 95 Prozent voll, obwohl Du nur eine Handvoll Container betreibst. Das liegt fast nie an Deinen eigentlichen Daten, sondern an alten Images, am Build-Cache und an Logdateien, die ohne Grenze wachsen. Hier siehst Du, wie Du die Ursache in einer Minute findest, was Du gefahrlos löschen kannst und wie Du verhinderst, dass es wieder passiert.

Die Anleitung gilt für Docker Engine 29 (aktuell 29.10) unter Ubuntu und Debian, auf einem Raspberry Pi mit Raspberry Pi OS funktioniert sie genauso. Alle Befehle und Warnmeldungen habe ich mit der offiziellen Docker-Dokumentation zum Aufräumen abgeglichen, Stand November 2026.

Erst messen: Wo steckt der Platz?

Bevor Du irgendetwas löschst, schau Dir an, was überhaupt so groß ist. Der erste Befehl zeigt, wie voll das Dateisystem ist, auf dem Docker seine Daten ablegt:

Code
df -h /var/lib/docker

Danach fragst Du Docker selbst, wie sich der belegte Platz verteilt:

Code
docker system df

Die Ausgabe sieht ungefähr so aus:

Code
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          23        6         8.412GB   6.03GB (71%)
Containers      9         6         312.4MB   41.2MB (13%)
Local Volumes   12        5         2.87GB    1.1GB (38%)
Build Cache     148       0         4.26GB    4.26GB

Die Spalte ACTIVE zählt, was gerade von einem Container benutzt wird, und RECLAIMABLE sagt Dir, wie viel Platz Du ohne Eingriff in laufende Dienste zurückholen könntest. Im Beispiel liegen also gut zehn Gigabyte in Images und Build-Cache, die keiner mehr braucht. Willst Du sehen, welches Image oder Volume genau wie groß ist, hängst Du -v an: docker system df -v listet jedes Image, jeden Container und jedes Volume einzeln auf.

Eine Zeile fehlt in dieser Übersicht allerdings, und sie ist oft die größte: die Logdateien der Container. Darum kümmern wir uns weiter unten gesondert.

Was die prune-Befehle löschen

Docker räumt mit den prune-Befehlen auf. Jeder davon fragt vorher nach und nennt Dir, welche Art von Daten er entfernen wird. Gehe sie in dieser Reihenfolge durch, vom harmlosesten zum heikelsten.

BefehlWas er entferntRisiko
docker builder pruneBuild-Cache, der von keinem Build mehr gebraucht wirdkeins, der nächste Build dauert nur länger
docker image prune„dangling“ Images ohne Namen, meist Reste alter Updateskeins
docker container prunealle gestoppten Containergering, wenn Du einen gestoppten Container noch brauchst
docker image prune -aalle Images, die kein Container benutztgering, sie werden bei Bedarf neu geladen
docker volume pruneungenutzte anonyme Volumesprüfen, siehe unten

Build-Cache und alte Images

Der Build-Cache wächst vor allem, wenn Du auf dem Server selbst Images baust, etwa mit docker compose build oder einem selbst gehosteten CI-Runner. Ihn zu leeren ist ungefährlich:

Code
docker builder prune

Bestätige die Rückfrage mit y. Danach entfernst Du die namenlosen Image-Reste, die bei jedem Update übrig bleiben:

Code
docker image prune

Images ohne Namen entstehen immer dann, wenn Du docker compose pull ausführst und ein neues Image den Namen des alten übernimmt. Wer seine Container regelmäßig aktualisiert, sammelt davon schnell einige Gigabyte. Wie Du dabei nicht den Überblick verlierst, zeigt Dir der Artikel Docker-Container aktualisieren: Diun statt Watchtower.

Gestoppte Container und ungenutzte Images

Gestoppte Container belegen selbst wenig Platz, halten aber ihr Image fest, sodass Docker es nicht löschen kann. Räum sie deshalb vor den Images auf:

Code
docker container prune
docker image prune -a

Der zweite Befehl entfernt jedes Image, das gerade kein Container benutzt, also auch Images von Stacks, die Du nur vorübergehend gestoppt hast. Das ist harmlos, weil docker compose up -d sie beim nächsten Start einfach wieder herunterlädt. Docker warnt vorher mit WARNING! This will remove all images without at least one container associated to them., das ist an dieser Stelle erwartet.

Statt der Einzelbefehle kannst Du auch docker system prune -a nutzen. Er erledigt Container, Netzwerke, ungenutzte Images und den Build-Cache in einem Rutsch und zeigt Dir vorher die Liste.

Volumes nur mit Bedacht

In Volumes liegen Deine eigentlichen Daten: Datenbanken, Uploads, Konfigurationen. Deshalb löscht Docker sie nie von selbst mit, und genau so soll es bleiben. docker volume prune entfernt seit Docker 23 nur noch anonyme Volumes, die kein Container benutzt. Benannte Volumes wie nextcloud_db bleiben dabei stehen.

Schau Dir trotzdem vorher an, was betroffen wäre:

Code
docker volume ls -f dangling=true

Die Liste zeigt alle Volumes, die gerade kein Container verwendet, anonyme und benannte. Findest Du dort ein benanntes Volume eines Projekts, das Du endgültig entfernt hast, löschst Du es gezielt mit docker volume rm <name>, wobei Du <name> durch den Namen aus der Liste ersetzt. Von docker volume prune -a rate ich ab: Es entfernt auch die benannten Volumes aller Stacks, zu denen gerade kein Container existiert, und damit bist Du Deine Datenbank los, wenn Du einen Dienst nur vorübergehend mit docker compose down heruntergefahren hast. Warum Daten in Volumes überhaupt getrennt vom Container liegen, erklärt der Artikel Docker Compose verstehen: Volumes, Netzwerke und .env.

Der heimliche Speicherfresser: Container-Logs

Docker schreibt alles, was ein Container auf die Konsole ausgibt, in eine Logdatei. Der Standard-Logtreiber json-file macht das ohne jede Rotation, die Datei wächst also, solange der Container läuft. Ein gesprächiger Dienst bringt es so in einem Jahr auf etliche Gigabyte, und docker system df zeigt davon nichts.

Die größten Logdateien findest Du mit diesem Befehl:

Code
sudo sh -c 'du -h /var/lib/docker/containers/*/*-json.log' | sort -h | tail -5

Die Ausgabe nennt die fünf größten Logs mit dem Container-Verzeichnis, dessen Name mit der Container-ID beginnt. Welcher Container zu einer ID gehört, zeigt docker ps -a --format '{{.ID}} {{.Names}}', die ersten zwölf Zeichen genügen zum Vergleichen.

Lösch oder kürze diese Dateien nicht von Hand. Die Docker-Doku sagt ausdrücklich, dass nur der Docker-Daemon auf sie zugreifen soll, und ein Eingriff von außen kann das Logging des Containers durcheinanderbringen. Der saubere Weg ist, Docker eine Obergrenze vorzugeben und die Container danach neu zu erstellen.

Log-Rotation dauerhaft einschalten

Docker empfiehlt selbst den Logtreiber local, der Logs automatisch rotiert und komprimiert. Pro Container behält er standardmäßig fünf Dateien zu je 20 MB, also höchstens 100 MB. Öffne dazu die Konfigurationsdatei des Daemons:

Code
sudo nano /etc/docker/daemon.json

Gibt es die Datei noch nicht, ist sie jetzt leer, und Du trägst Folgendes ein:

Code
{
  "log-driver": "local"
}

Steht in der Datei schon etwas, ergänzt Du nur die Zeile "log-driver": "local" innerhalb der geschweiften Klammern und trennst sie mit einem Komma von den übrigen Einträgen. Speichere mit Strg + O, bestätige mit Enter und schließe den Editor mit Strg + X. Danach startest Du Docker neu:

Code
sudo systemctl restart docker

Kommt dabei eine Fehlermeldung, enthält die Datei meist einen Tippfehler, etwa ein fehlendes Komma. sudo journalctl -u docker -n 20 zeigt Dir die genaue Ursache.

Bestehende Container neu erstellen

Die neue Einstellung gilt nur für Container, die nach dem Neustart erstellt werden. Ein einfacher Neustart eines Containers reicht nicht. Wechsle deshalb in jedes Compose-Projekt und lass die Container neu anlegen:

Code
cd /opt/meinprojekt
docker compose up -d --force-recreate

Ersetze /opt/meinprojekt durch den Ordner, in dem die compose.yaml des Projekts liegt. Deine Daten bleiben dabei erhalten, weil sie in den Volumes liegen und nicht im Container. Weil Docker den alten Container samt seiner Logdatei entfernt, ist der Platz der riesigen Logs danach sofort wieder frei.

Ob die Umstellung gegriffen hat, prüfst Du für jeden Container mit:

Code
docker inspect -f '{{.HostConfig.LogConfig.Type}}' <container>

Die Ausgabe muss local lauten. docker logs funktioniert mit dem neuen Treiber genau wie vorher.

Neuinstallationen ab Docker 29: zweiter Speicherort

Hast Du Docker ab Version 29 frisch installiert, verwendet es den containerd-Image-Speicher. Images und Container-Schichten liegen dann nicht mehr in /var/lib/docker, sondern in /var/lib/containerd, nur Volumes und Konfiguration bleiben am alten Ort. Prüfst Du den Platz mit du, schau deshalb in beide Ordner:

Code
sudo du -sh /var/lib/docker /var/lib/containerd

Docker-Installationen, die von einer älteren Version aktualisiert wurden, behalten das alte Verfahren mit allem unter /var/lib/docker. An den prune-Befehlen ändert das nichts. Die Platzangaben von docker system df hat Docker für containerd allerdings in mehreren 29er-Versionen korrigiert, halte Docker deshalb aktuell.

Regelmäßig automatisch aufräumen

Damit sich alte Images gar nicht erst stapeln, lässt Du einmal pro Woche aufräumen. Öffne dazu die Crontab des Root-Benutzers:

Code
sudo crontab -e

Trag am Ende diese Zeile ein:

Code
0 4 * * 0 /usr/bin/docker system prune -af --filter "until=168h" > /dev/null

Sonntags um vier Uhr entfernt Docker damit gestoppte Container, ungenutzte Netzwerke und Images sowie Build-Cache, die älter als sieben Tage sind. -f überspringt die Rückfrage, die in einem Cronjob niemand beantworten könnte. Volumes fasst dieser Befehl nicht an, und dabei sollte es bei einer Automatik auch bleiben. Wie die Zeitangaben in der Crontab aufgebaut sind, erklärt die Anleitung: Cronjobs unter Raspberry Pi OS einrichten, die auch für Ubuntu und Debian gilt.

Wenn trotzdem kein Platz frei wird

  • RECLAIMABLE zeigt viel, aber prune gibt wenig frei: Die Images gehören zu gestoppten Containern. Entferne zuerst die Container mit docker container prune, danach lassen sich die Images löschen.
  • Die Platte bleibt voll, obwohl Docker kaum etwas meldet: Dann sind es fast immer die Logs, siehe oben, oder Daten außerhalb von Docker. Mit sudo du -h --max-depth=1 / 2>/dev/null | sort -h siehst Du, welcher Ordner auf der obersten Ebene am größten ist.
  • Ein Volume ist riesig: Dann wächst die Anwendung selbst, zum Beispiel eine Datenbank oder ein Upload-Ordner. Das löst kein prune, sondern nur das Aufräumen in der Anwendung oder mehr Speicher.

Kurz gesagt

Der Speicher auf einem Docker-Server läuft fast immer aus drei Gründen voll: alte Images, Build-Cache und Logs ohne Grenze. Die ersten beiden räumst Du mit docker system prune -a gefahrlos weg, die Logs bändigst Du dauerhaft mit dem Treiber local und einem einmaligen Neuerstellen der Container. Nur bei Volumes lohnt jedes Mal ein zweiter Blick, denn dort liegen die Daten, die Du nicht wiederbekommst.

Weiterlesen.