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 Nathan Base
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:
df -h /var/lib/dockerDanach fragst Du Docker selbst, wie sich der belegte Platz verteilt:
docker system dfDie Ausgabe sieht ungefähr so aus:
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.26GBDie 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.
| Befehl | Was er entfernt | Risiko |
|---|---|---|
docker builder prune | Build-Cache, der von keinem Build mehr gebraucht wird | keins, der nächste Build dauert nur länger |
docker image prune | „dangling“ Images ohne Namen, meist Reste alter Updates | keins |
docker container prune | alle gestoppten Container | gering, wenn Du einen gestoppten Container noch brauchst |
docker image prune -a | alle Images, die kein Container benutzt | gering, sie werden bei Bedarf neu geladen |
docker volume prune | ungenutzte anonyme Volumes | prü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:
docker builder pruneBestätige die Rückfrage mit y. Danach entfernst Du die namenlosen Image-Reste, die bei jedem Update übrig bleiben:
docker image pruneImages 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:
docker container prune
docker image prune -aDer 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:
docker volume ls -f dangling=trueDie 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:
sudo sh -c 'du -h /var/lib/docker/containers/*/*-json.log' | sort -h | tail -5Die 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:
sudo nano /etc/docker/daemon.jsonGibt es die Datei noch nicht, ist sie jetzt leer, und Du trägst Folgendes ein:
{
"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:
sudo systemctl restart dockerKommt 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:
cd /opt/meinprojekt
docker compose up -d --force-recreateErsetze /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:
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:
sudo du -sh /var/lib/docker /var/lib/containerdDocker-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:
sudo crontab -eTrag am Ende diese Zeile ein:
0 4 * * 0 /usr/bin/docker system prune -af --filter "until=168h" > /dev/nullSonntags 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
RECLAIMABLEzeigt viel, aberprunegibt wenig frei: Die Images gehören zu gestoppten Containern. Entferne zuerst die Container mitdocker 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 -hsiehst 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.
-
Selfhosting & WebDocker Compose verstehen: Volumes, Netzwerke und .env
Docker Compose verständlich erklärt: Named Volume oder Bind Mount, Dienstnamen als Hostnamen, .env-Variablen, Healthchecks, sichere Updates und Backups.
Nathan Base -
Selfhosting & WebDocker-Container aktualisieren: Diun statt Watchtower
Watchtower ist eingestellt. Mit Diun und ntfy erfährst Du von neuen Docker-Images und aktualisierst Container kontrolliert statt blind.
Nathan Base -
Raspberry Pi & LinuxAnleitung: Cronjobs unter Raspberry Pi OS einrichten
Cronjobs unter Raspberry Pi OS Trixie einrichten: Zeitzone setzen, crontab verstehen, Bash- und Python-Scripts samt venv starten und Fehler protokollieren.
Nathan Base -
Selfhosting & WebGitHub Actions Minuten aufgebraucht: Runner mit Coolify
Actions-Minuten zu 90 % verbraucht? So richtest Du mit Coolify einen eigenen Runner für Deine GitHub-Organisation ein, auch mit GitHub Free.
Nathan Base -
Selfhosting & WebAnleitung: linkding mit Docker selbst hosten
linkding ist ein schlanker Bookmark-Manager zum Selbsthosten. So richtest Du ihn mit Docker Compose ein und verbindest die Browser-Erweiterung.
Nathan Base -
Selfhosting & WebAnleitung: Linkwarden mit Docker selbst hosten
Linkwarden speichert Lesezeichen und archiviert jede Seite als Screenshot, PDF und HTML. So richtest Du es mit Docker Compose auf Deinem Server ein.
Nathan Base