Lorixen.
DE

Docker frisst die Festplatte: Images und Logs aufräumen

Kurz gesagt: Auf Servern, auf denen Websites oder Web-Apps mit Docker laufen, füllt sich die Festplatte oft schleichend. Alte Images nach jedem Deploy, gestoppte Container, der Build-Cache und vor allem Protokolldateien ohne Größenbegrenzung können Gigabytes belegen, bis Datenbanken nicht mehr schreiben und Deploys scheitern. Mit docker system df sehen Sie, wo der Platz hingeht. Die Prune-Befehle räumen gezielt auf, und eine Grenze für Container-Protokolle verhindert, dass das Problem wiederkommt. Dieser Artikel zeigt die Reihenfolge, in der Sie vorgehen sollten, und wo Vorsicht geboten ist, vor allem bei Volumes mit Daten.

Wo der Platz hingeht

Der erste Befehl verschafft Überblick:

docker system df
docker system df -v

Laut Docker-Dokumentation zeigt docker system df Informationen über den Speicherplatz, den der Docker-Dienst belegt. Die Ausgabe unterteilt nach Images, Containern, lokalen Volumes und Build-Cache und nennt jeweils, wie viel davon zurückgewonnen werden könnte. Die ausführliche Variante mit -v listet einzelne Images und Volumes auf.

Was docker system df nicht direkt zeigt, sind Protokolldateien. Diese liegen beim Standard-Protokolltreiber neben den Containerdaten im Docker-Verzeichnis, meist unter /var/lib/docker/containers. Ein du -sh auf die Unterordner zeigt schnell, ob ein einzelner Container riesige Protokolle angehäuft hat.

Warum sich Docker-Daten ansammeln

Die Docker-Dokumentation erklärt, dass Docker ungenutzte Objekte wie Images, Container, Volumes und Netzwerke grundsätzlich nicht von selbst entfernt, solange Sie es nicht ausdrücklich anweisen. Bei jedem Deploy mit einer neuen Image-Version bleibt die alte liegen. Wird ein Image unter demselben Namen neu gebaut, verliert die vorherige Version ihren Namen und wird zu einem sogenannten verwaisten Image. Laut Dokumentation ist ein solches Image eines, das keinen Tag mehr hat und von keinem Container verwendet wird.

Hinzu kommt der Build-Cache, wenn auf demselben Server gebaut wird, und Container, die gestoppt, aber nie entfernt wurden.

In sicherer Reihenfolge aufräumen

Gehen Sie von harmlos zu riskant vor:

1. Verwaiste Images entfernen. docker image prune entfernt laut Dokumentation standardmäßig nur verwaiste Images. Das ist fast immer unbedenklich.

2. Ungenutzte Images mit Zeitfilter entfernen. docker image prune -a entfernt alle Images, die von keinem Container genutzt werden. Mit einem Filter wie --filter "until=24h" beschränken Sie das auf ältere Images, wie es die Dokumentation zeigt. Bedenken Sie, dass Sie für einen schnellen Rückschritt auf die vorherige Version deren Image eventuell noch brauchen.

3. Gestoppte Container entfernen. docker container prune entfernt alle gestoppten Container. Prüfen Sie vorher mit docker ps -a, ob darunter Container sind, die Sie bewusst angehalten haben.

4. Build-Cache leeren. docker builder prune entfernt den Build-Cache. Der nächste Build dauert dann länger, sonst ändert sich nichts.

5. Volumes nur mit großer Vorsicht. In Volumes liegen oft Datenbanken, Uploads und andere Daten, die nicht verloren gehen dürfen.

Der Sammelbefehl und seine Grenzen

docker system prune räumt laut Dokumentation mehrere Objektarten auf einmal auf: Images, Container, Netzwerke und ungenutzten Build-Cache. Volumes werden standardmäßig nicht entfernt. Mit --volumes werden zusätzlich ungenutzte anonyme Volumes gelöscht, benannte ungenutzte Volumes bleiben laut Dokumentation unberührt. Sie lassen sich nur mit docker volume prune --all entfernen.

Gerade die Option --volumes sollten Sie nicht aus Gewohnheit setzen. „Ungenutzt“ bedeutet nur, dass gerade kein Container das Volume eingebunden hat. Wurde ein Datenbank-Container für eine Wartung gestoppt und entfernt, gilt sein Volume ebenfalls als ungenutzt.

Protokolle begrenzen

Der häufigste Grund für volle Festplatten auf Docker-Servern sind Protokolle. Laut Dokumentation des Protokolltreibers json-file steht die Option max-size standardmäßig auf -1, also unbegrenzt. Ein Container, der viel schreibt, kann so über Wochen sehr große Protokolldateien erzeugen.

Die Dokumentation zeigt, wie Sie in der Datei daemon.json den Treiber und die Optionen max-size und max-file setzen, damit Protokolle automatisch rotiert werden:

{
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "3" }
}

Wichtig: Laut Dokumentation müssen Sie Docker danach neu starten, und die Einstellung gilt nur für neu erstellte Container. Bestehende Container übernehmen die neue Konfiguration nicht automatisch. Sie müssen neu erstellt werden, etwa beim nächsten Deploy. In Compose-Dateien können Sie die Optionen auch pro Dienst festlegen.

Vor dem Aufräumen absichern

Bevor Sie größere Mengen löschen, nehmen Sie sich fünf Minuten für eine Bestandsaufnahme. Notieren Sie mit docker ps -a, welche Container laufen und welche gestoppt sind, und mit docker volume ls, welche Volumes existieren. Prüfen Sie, ob für die Datenbanken eine aktuelle Sicherung außerhalb der Volumes vorliegt. Und klären Sie, welche Image-Version gerade produktiv läuft und welche vorherige Version Sie für einen Rückschritt behalten möchten. Diese kurze Liste verhindert, dass ein Aufräumbefehl in Eile genau das entfernt, was Sie am nächsten Tag brauchen. Arbeiten Sie außerdem nicht als einzige Person auf dem Server, sprechen Sie sich mit dem Team ab, damit niemand parallel deployt.

Regelmäßig statt im Notfall

Nach der ersten großen Aufräumaktion sollte ein Zeitplan dafür sorgen, dass sich nichts mehr anstaut:

  • Ein wöchentlicher Lauf von docker image prune -a --filter "until=168h" und docker builder prune mit ähnlichem Filter.
  • Protokollgrenzen für alle Container, ob über daemon.json oder pro Dienst.
  • Eine Überwachung der Festplattenbelegung mit Warnung ab einer Schwelle, bei der noch Zeit zum Handeln bleibt.
  • Bei Deploys höchstens die aktuelle und die vorherige Image-Version behalten.

Wenn Images ohnehin auf einem separaten Build-System entstehen, braucht der Produktionsserver keinen Build-Cache. Das allein spart oft viel Platz.

Beispiel zur Veranschaulichung

Ein Innsbrucker Skiverleih (Beispiel zur Veranschaulichung) betreibt seine Buchungsplattform mit mehreren Containern auf einem Server. Eines Morgens scheitert der Deploy mit vollem Speicher. docker system df zeigt Dutzende alte Images, du -sh auf das Container-Verzeichnis einen einzelnen Dienst mit mehreren Gigabyte Protokoll. Das Team entfernt verwaiste und alte Images mit Zeitfilter, setzt max-size und max-file in der Compose-Datei, erstellt die Container neu und richtet einen wöchentlichen Aufräumlauf ein. Die Volumes der Datenbank bleiben unangetastet.

Typische Fehler

  • docker system prune -a --volumes aus einer Anleitung kopieren, ohne die Folgen für Daten zu kennen.
  • Protokolle unbegrenzt wachsen lassen.
  • Die Protokollgrenze setzen, aber bestehende Container nicht neu erstellen.
  • Alle alten Images löschen und dann keinen schnellen Rückschritt mehr haben.
  • Erst aufräumen, wenn der Server schon steht.

Häufige Fragen

Kann ich Protokolldateien einfach von Hand löschen?

Davon ist abzuraten, weil der laufende Container die Datei weiter offen hält. Besser ist eine Größenbegrenzung über die Protokolloptionen.

Löscht docker system prune meine Datenbank?

Ohne --volumes werden Volumes nicht entfernt. Mit der Option werden ungenutzte anonyme Volumes gelöscht, benannte bleiben bestehen.

Wie oft sollte ich aufräumen?

Eine wöchentliche, automatische Bereinigung mit Zeitfilter ist für die meisten kleinen Server ausreichend.

Wenn Ihr Docker-Server regelmäßig vollläuft und Sie eine sichere, automatische Bereinigung möchten, richten wir sie gern mit Ihnen ein: Server aufräumen lassen.

Quellen

WhatsAppTermin buchen