Sicher auf dem Laufenden – Teil 7: Watchtower – Auto-Updates, die funktionieren (und drei Fallen, die lauern)
Watchtower ist ein kleiner Helfer-Container, der regelmäßig prüft, ob für deine laufenden Container neuere Images da sind, und sie dann von selbst neu startet. Zusammen mit dem Wochen-Scan aus Teil 5 ergibt das eine bequeme Aufteilung:
• Watchtower hält die latest-Container automatisch frisch.
• Trivy + KEV (Teil 5) sagen dir, wo trotzdem etwas klemmt.
Einrichtung in vier Schritten
1) Die Compose-Datei (watchtower/docker-compose.yml):
services:
watchtower:
image: ghcr.io/containrrr/watchtower:latest
container_name: watchtower
restart: unless-stopped
volumes:
- /var/run/docker.sock:/var/run/docker.sock
environment:
- DOCKER_API_VERSION=1.41
- WATCHTOWER_SCHEDULE=0 0 4 * * *
- WATCHTOWER_CLEANUP=true
- WATCHTOWER_LABEL_ENABLE=true
2) Starten: docker compose up -d
3) Opt-in pro Container – nur Container mit diesem Label werden aktualisiert:
# im jeweiligen Service, z. B. dein node-exporter:
labels:
- com.centurylinklabs.watchtower.enable=true
4) Kontrollieren: docker logs watchtower (sollte in etwa zeigen:
„Only checking containers using enable label")
LABEL_ENABLE würde Watchtower
alle Container anfassen – auch solche, die du bewusst gepinnt hast oder die einen
eigenen Update-Mechanismus besitzen (z. B. die Container von Nextcloud AIO). Mit dem Label
entscheidest du pro Dienst, wer automatisch aktualisiert wird und wer nicht.
Falle 1: Das Download-Quelle-Problem
Der Klassiker, der uns selbst erwischt hat: Das Docker-Hub-Image
containrrr/watchtower:latest wird seit Jahren nicht mehr gepflegt – wer
es nutzt, holt sich auf Dauer einen uralten Stand ohne Updates. Verwende deshalb direkt das gepflegte
Image von der Container-Registries-Quelle des Projekts:
image: ghcr.io/containrrr/watchtower:latest
Regel: Bevor du irgendein „:latest"-Image benutzt, einmal kurz prüfen, ob die Quelle überhaupt noch lebt (Release-Seite/GitHub anschauen schadet nie).
Falle 2: „client version 1.25 is too old"
Direkt nach der Einrichtung hängt Watchtower im Neustart-Loop und spuckt:
Error response from daemon: client version 1.25 is too old. Minimum supported API version is 1.40 …
Das bedeutet: Deine Docker-Version akzeptiert nur noch neuere Schnittstellen – dein
Daemon-Mindeststandard ist hochgesetzt. Die Lösung ist eine Env-Variable in der Compose-Datei (siehe
oben): DOCKER_API_VERSION=1.41. Damit spricht Watchtower eine vom Daemon akzeptierte
Sprachversion und läuft.
Falle 3: „Er hat ALLES angefasst" oder „er hat gar nichts gemacht"
Zwei Seiten derselben Münze:
• Ohne LABEL_ENABLE fasst Watchtower jeden Container an – inklusive
Managed Stacks (Nextcloud AIO, Docker-UI-Eigenverwaltung …), die ihren eigenen
Update-Rhythmus haben. Ergebnis: zerstrittene Automatismen, im Zweifel ein gebrochener Dienst. → Immer
das Opt-in-Label verwenden.
• Mit LABEL_ENABLE, aber ohne Labels passiert dagegen
gar nichts – du denkst „automatisch up to date", doch kein Container trägt ein Label. →
Nach der Einrichtung einmal docker ps prüfen und die gelabelten Dienste sehen.
Und eine ehrliche Grenze: Gepinnte Versionen (z. B. traefik:3.7.14
oder cadvisor:0.60.5) aktualisiert Watchtower bewusst nicht – ein Tag ist ein fester Stand,
kein „latest". Genau dafür bleibt der Scan aus Teil 5 dein Kontrollinstrument.
Für Fortgeschrittene
• Schedule statt Intervall: WATCHTOWER_SCHEDULE=0 0 4 * * *
(Cron-Syntax) ist bestimmter als ein Intervall; die offizielle Doku des Projekts ist die Wahrheit bei
den vielen WATCHTOWER_*-Optionen.
• Scope-Konzept: Mit --scope + com.centurylinklabs.watchtower.enable=false
lassen sich gezielt Ausnahmen definieren; auch eine Whitelist von Container-Namen ist möglich.
• Cleanup: WATCHTOWER_CLEANUP=true entfernt alte Image-Stände nach dem
Update – spart Platz, aber behalte ein vorheriges Image als Rollback-Möglichkeit (Snapshot).
• Watchtower kann nicht: CVE-Scores prüfen, KEV abgleichen oder Host-Pakete
aktualisieren. Das machen Trivy/KEV (Teil 5) und apt upgrade (Teil 6) – die Teile ergänzen
sich, sie ersetzen sich nicht.
Warum das wichtig ist: Automatisierte Updates sparen Zeit – aber nur, wenn du steuerst, was automatisiert wird und die Quelle lebendig ist. Genau dafür stehen die drei Fallen.
Nächster Teil: Teil 8 – Routine & Ruhe: dein Monats-Check und der ruhige Umgang mit Alarmen.