Sicher auf dem Laufenden – Teil 7: Watchtower – Auto-Updates, die funktionieren (und drei Fallen, die lauern)

Kategorie: Projekte / CVE-Check | Lesezeit: ca. 7 Minuten
Watchtower überwacht gezielt freigegebene Container für automatische Updates
Serienübersicht: Kannst du Container nicht einfach automatisch aktuell halten? Ja – mit Watchtower. Aber nur, wenn du drei Stolperfallen kennst. Genau darum geht es heute.

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")

Warum das Label so wichtig ist: Ohne 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.

Nur ausdrücklich freigegebene Container gelangen in den automatischen Update-Ablauf

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.

KI-unterstützt KI-unterstützt