SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

Watchtower-Ersatz: Docker-Updates sicher automatisieren

containrrr/watchtower ist archiviert und scheitert an Docker 29. So stellen Sie auf den Fork, What's Up Docker oder Diun um, ohne dass die Datenbank ungefragt ein Update bekommt.

Watchtower-Ersatz: die kurze Antwort

Einen Watchtower-Ersatz brauchen Sie aus zwei Gründen. containrrr/watchtower ist seit dem 17. Dezember 2025 archiviert, und das alte Image scheitert an Docker Engine 29 mit einem API-Fehler. Für automatische Updates gibt es den gepflegten Fork nickfedor/watchtower. What's Up Docker (WUD) zeigt verfügbare Updates in einem Dashboard. Diun meldet neue Images nur per ntfy oder E-Mail und ändert selbst nichts.

Das Werkzeug ist aber nicht die wichtigste Entscheidung. Wichtiger ist die Regel, welcher Container sich selbst aktualisieren darf. Zustandslose Frontends dürfen das. Datenbanken und alles, was beim Start Migrationen ausführt, bekommen nur eine Nachricht. Diese Container aktualisieren Sie selbst, nach einem Backup und mit festen Image-Tags.

Alle Versionsangaben in dieser Anleitung haben wir am 21. November 2026 in den Quellen der Projekte geprüft. Alle Befehle führen Sie auf Ihrem eigenen Server aus. Sie brauchen dafür einen laufenden Docker-Daemon und Docker Compose.

Was mit containrrr/watchtower passiert ist

Das Repository containrrr/watchtower wurde am 17. Dezember 2025 archiviert und ist seitdem schreibgeschützt. Die README sagt klar, dass das Projekt nicht mehr gepflegt wird. In der Ankündigung (Discussion #2135) schreiben die Maintainer, dass sie Docker kaum noch selbst nutzen und ihnen Interesse und Zeit fehlen. Es kommen also keine Fehlerbehebungen und keine Sicherheitsupdates mehr. Ein Werkzeug mit Zugriff auf den Docker-Socket sollte aber gepflegt sein. Warum, steht weiter unten.

Der zweite Grund ist technisch. Docker Engine 29.0.0 erschien am 10. November 2025. Seit dieser Version verlangt der Daemon die API-Version v1.44 oder neuer, also einen Client auf dem Stand von Docker 25.0 oder später. Das alte Watchtower-Image spricht eine viel ältere API-Version. Nach dem Docker-Upgrade bricht es deshalb ab. In Issue #2124 steht die Meldung so im Log:

Error response from daemon: client version 1.25 is too old. Minimum supported API version is 1.44, please upgrade your client to a newer version

Docker 29.3.0 vom 5. März 2026 hat die Untergrenze wieder auf v1.40 gesenkt. Das entspricht Docker 19.03. Aktuell ist Docker Engine 29.10.0 vom 16. November 2026 mit der API-Version 1.57. Die Release Notes dieser Version nennen keine Änderung an der Untergrenze. Auch 1.40 liegt aber über der 1.25, die das alte Image meldet. Das alte Image läuft deshalb auch auf neueren 29er-Versionen nicht, solange Sie nichts ändern. Nur die Mindestversion im Fehlertext kann dort anders lauten.

Welche Engine auf Ihrem Server läuft, zeigt dieser Befehl:

docker version --format '{{.Server.Version}} {{.Server.APIVersion}}'

Die erste Zahl ist die Engine-Version. Die zweite ist die höchste API-Version, die der Daemon spricht.

Hilft DOCKER_API_VERSION noch als Notlösung?

Im offenen Original-Issue #2122 berichten Nutzer, dass eine Umgebungsvariable das alte Image wieder zum Laufen bringt. Genannt werden die Werte 1.44, 1.51 und 1.52 für DOCKER_API_VERSION. Andere sind auf Docker 28 zurückgegangen. Diese Berichte stammen aus November und Dezember 2025 und betreffen Docker 29.0.x. Es sind Erfahrungen von Nutzern, keine Herstellerangaben.

Der Mechanismus dahinter ist dokumentiert. DOCKER_API_VERSION legt die API-Version des Clients fest und schaltet die Aushandlung mit dem Daemon ab. Der Client nutzt dann genau diese Version, auch wenn der Daemon eine neuere kann. Der Wert muss deshalb in dem Bereich liegen, den der Daemon annimmt. Auf 29.0 bis 29.2 heißt das: 1.44 oder höher. Ab 29.3 liegt die Untergrenze bei 1.40, und 29.10 spricht bis 1.57. Der Wert 1.44 liegt in beiden Fällen im erlaubten Bereich.

Ob diese Notlösung auf Docker 29.10 noch funktioniert, haben wir nicht gemessen. Prüfen Sie es auf Ihrem Server selbst. Ergänzen Sie dazu im bestehenden Compose-File die Variable:

services:
  watchtower:
    image: containrrr/watchtower
    environment:
      - DOCKER_API_VERSION=1.44
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
docker compose up -d watchtower
docker compose logs --tail 20 watchtower

Steht im Log wieder client version ... is too old, greift die Variable nicht. Fehlt die Meldung, verbindet sich der Container wieder mit dem Daemon. Auch dann bleibt es eine Notlösung, denn das Image bekommt keine Korrekturen mehr. Nutzen Sie die gewonnene Zeit für den Umstieg.

Die Regel: Welche Container dürfen sich selbst aktualisieren?

Ein automatisches Update läuft immer gleich ab. Das Werkzeug lädt ein neues Image, stoppt den Container und startet ihn mit dem neuen Image neu. Für einen Container ohne eigene Daten ist das harmlos. Funktioniert das neue Image nicht, starten Sie wieder das alte, und alles ist wie vorher.

Bei Containern mit Daten stimmt das nicht. Viele Anwendungen ändern beim Start das Schema ihrer Datenbank. Nach dieser Migration passt das alte Image oft nicht mehr zu den Daten. Ein Zurück ist dann nur mit einem Backup möglich, das vor dem Update entstanden ist. Bei Datenbanken selbst kommen Hauptversionen dazu. Ein Sprung von Postgres 16 auf 17 braucht einen eigenen Upgrade-Schritt für die Daten, und den macht kein Auto-Updater für Sie.

Daraus folgt eine einfache Aufteilung:

  • Automatisch aktualisieren: Reverse-Proxy, statische Websites und andere Frontends, deren Daten nicht im Container liegen.
  • Nur benachrichtigen: Postgres, MariaDB, Redis mit Persistenz und alle Anwendungen mit eigener Datenbank, zum Beispiel Nextcloud oder Paperless-ngx.

Für die zweite Gruppe gilt der Ablauf aus der Anleitung Docker-Compose-Stack sichern und kontrolliert aktualisieren. Sie kopieren die Compose-Dateien und die .env, dumpen die Datenbank im laufenden Betrieb und sichern die Volumes. Dann notieren Sie die laufenden Image-Tags und Digests und kopieren das Backup vom Server weg. Erst danach ändern Sie den Tag und starten neu.

Feste Tags gehören zu dieser Regel. Mit postgres:latest kann jedes docker compose pull eine neue Hauptversion holen. Auch ein Versionstag wie postgres:16.4 ist veränderbar: Der Herausgeber kann ihn auf ein anderes Image setzen. Nur ein festgelegter Digest garantiert dasselbe Image. Die Benachrichtigung sagt Ihnen, wann es Zeit dafür ist.

Jedes dieser Werkzeuge hat Root-Rechte auf dem Host

Alle Werkzeuge in dieser Anleitung binden /var/run/docker.sock ein. Über diesen Socket steuern sie den Docker-Daemon. Die Docker-Dokumentation sagt dazu: Nur vertrauenswürdige Nutzer sollen den Daemon steuern. Der Daemon läuft als root, wenn Sie nicht den Rootless-Modus nutzen. Er erlaubt außerdem Bind-Mounts ohne Einschränkung. Wer den Socket erreicht, kann also einen Container starten, der das Wurzelverzeichnis / des Hosts einbindet. Das bedeutet praktisch Root-Rechte auf dem ganzen Server.

Ein Mount mit :ro ändert daran nichts, denn er schränkt die API hinter dem Socket nicht ein. Für Sie folgen daraus zwei Dinge. Nutzen Sie nur gepflegte Projekte und pinnen Sie auch deren Image-Tag. Machen Sie Weboberflächen mit Socket-Zugriff, etwa die von WUD, nicht öffentlich erreichbar.

Option 1: der Fork nickfedor/watchtower 1.24.1

Der Fork ist aktiv gepflegt und nicht archiviert. Version v1.24.1 erschien am 18. November 2026 und ist als aktuelle Version markiert. Die Lizenz ist wie beim Original Apache-2.0. Auf Docker Hub heißt der Tag 1.24.1, ohne das v. Daneben gibt es latest und einen nightly-Tag. Pinnen Sie deshalb 1.24.1.

Für den Umstieg ändert sich wenig. Der Socket wird genauso eingebunden, und die Label-Namen sind dieselben wie bei containrrr, zum Beispiel com.centurylinklabs.watchtower.enable. Eine eigene Anleitung für den Wechsel vom Original enthalten README und Dokumentation nicht. Lesen Sie deshalb Ihre alte Konfiguration Zeile für Zeile gegen die Doku des Forks.

Den API-Fehler hat der Fork nicht. Er handelt die API-Version standardmäßig selbst mit dem Daemon aus. Setzen Sie DOCKER_API_VERSION, prüft er den Wert und fällt bei einem Fehler auf die Aushandlung zurück. Laut README ist er mit API v1.43 und neuer getestet. Die Notlösung aus dem letzten Abschnitt brauchen Sie also nicht mehr.

Stoppen Sie zuerst den alten Container, zum Beispiel mit docker compose down im alten Projektordner. Sonst laufen zwei Updater gleichzeitig, und der Containername watchtower ist schon belegt. Legen Sie dann /srv/watchtower/compose.yaml an:

services:
  watchtower:
    image: nickfedor/watchtower:1.24.1
    container_name: watchtower
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin
      - WATCHTOWER_LABEL_ENABLE=true
      - WATCHTOWER_SCHEDULE=0 4 * * *
      - WATCHTOWER_CLEANUP=true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

WATCHTOWER_LABEL_ENABLE=true ist die wichtigste Zeile. Ohne sie (Standard ist false) überwacht Watchtower jeden Container, außer denen mit dem Label false. Mit ihr überwacht er nur Container, die das Label ausdrücklich auf true setzen. Ein neuer Datenbank-Container ist so von Anfang an geschützt, auch wenn Sie ihn vergessen.

WATCHTOWER_SCHEDULE nimmt einen Cron-Ausdruck. Mit fünf Feldern beginnt er bei der Minute, 0 4 * * * heißt also täglich um 4:00 Uhr. Bei sechs Feldern steht vorne zusätzlich ein Sekundenfeld. Ohne TZ rechnet der Zeitplan in UTC, deshalb steht TZ=Europe/Berlin dabei. Den Zeitplan können Sie nicht mit WATCHTOWER_POLL_INTERVAL kombinieren. Dieser Wert zählt in Sekunden und steht standardmäßig auf 86400, also einmal pro Tag.

WATCHTOWER_CLEANUP steht standardmäßig auf false. Dann bleibt nach jedem Update das alte Image auf der Platte liegen. Wie Sie bereits angesammelte Reste finden und löschen, zeigt die Anleitung Docker-Speicherplatz auf dem VPS aufräumen.

Nun bekommt jedes Frontend das Label. Im Compose-File des Frontends sieht das so aus:

services:
  web:
    image: nginx:1.27
    restart: unless-stopped
    labels:
      - com.centurylinklabs.watchtower.enable=true

Der Datenbank-Container bekommt kein Label. Wer es ausdrücklich sehen will, setzt dort com.centurylinklabs.watchtower.enable=false. Starten Sie den Updater und prüfen Sie das Label am Frontend:

cd /srv/watchtower
docker compose up -d
docker compose logs --tail 20 watchtower
docker inspect --format '{{ index .Config.Labels "com.centurylinklabs.watchtower.enable" }}' web

Ersetzen Sie web durch den Namen aus docker ps. Compose nennt Container oft projekt-web-1. Der letzte Befehl soll true ausgeben. Eine leere Zeile bedeutet: Das Label fehlt, und Watchtower lässt diesen Container in Ruhe. Haben Sie das Label im Compose-File ergänzt, wird es erst nach docker compose up -d im Projekt des Frontends aktiv, weil Labels beim Erstellen des Containers gesetzt werden.

Option 2: What's Up Docker 9.8.0 mit Dashboard

What's Up Docker erschien am 7. November 2026 in Version 9.8.0. Die Lizenz ist MIT, das Image heißt getwud/wud (auch unter ghcr.io/getwud/wud). Das Beispiel im Quick Start nennt keinen Tag. Pinnen Sie 9.8.0 selbst.

WUD verlangt immer eine Anmeldung, für die Oberfläche und für die API. Gibt es keinen Administrator, keine Bootstrap-Zugangsdaten und keine konfigurierte OIDC-Administratorgruppe, startet WUD gar nicht. Den ersten Administrator legen Sie beim ersten Start mit WUD_AUTH_ADMIN_USER und WUD_AUTH_ADMIN_PASSWORD an. Das Passwort gehört in eine .env-Datei, nicht ins Compose-File. Wie das sauber geht, beschreibt Passwörter und Secrets mit .env-Dateien in Docker Compose.

services:
  wud:
    image: getwud/wud:9.8.0
    container_name: wud
    restart: unless-stopped
    environment:
      - WUD_AUTH_ADMIN_USER=admin
      - WUD_AUTH_ADMIN_PASSWORD=${WUD_ADMIN_PASSWORD}
      - WUD_WATCHER_LOCAL_WATCHBYDEFAULT=false
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - 127.0.0.1:3000:3000

Der Port ist nur an 127.0.0.1 gebunden. Das Dashboard ist also nicht aus dem Internet erreichbar, denn wer es bedienen kann, steuert indirekt den Daemon. Sie öffnen es über einen SSH-Tunnel und dann http://localhost:3000 im Browser:

ssh -L 3000:127.0.0.1:3000 benutzer@ihr-server

Die Angaben zum Verhalten stammen aus der aktuellen Online-Dokumentation für 9.x, nicht aus dem Tag 9.8.0. Der Standard-Watcher heißt local. Er prüft stündlich nach dem Cron-Ausdruck 0 * * * *, überwacht standardmäßig alle Container und lässt gestoppte Container aus. Mit WUD_WATCHER_LOCAL_WATCHBYDEFAULT=false wird das Überwachen zur Ausnahme. Dann zeigt WUD nur Container mit dem Label wud.watch=true. Für Regeln pro Container kennt der Quellcode von 9.8.0 weitere Labels, darunter wud.tag.include, wud.tag.exclude, wud.watch.digest, wud.trigger.include und wud.trigger.exclude. Wie die Tag-Filter genau arbeiten, lesen Sie in der Dokumentation unter getwud.app nach.

Ohne Trigger zeigt WUD Updates nur an. Vorsicht bei den Triggern, die Container ändern. Die gemeinsame Option AUTO steht standardmäßig auf true. Ein Docker-Trigger ohne AUTO=false aktualisiert also automatisch die Container, die seine Filter zulassen, auch eine so ausgewählte Datenbank. Der Docker-Compose-Trigger geht noch weiter: Er ändert die Compose-YAML auf der Platte und erstellt den Container neu. Die Datei findet er über die Compose-Labels des Containers, und seine Option BACKUP steht standardmäßig auf false. Ihre festen Tags im Compose-File ändern sich dann ohne Ihr Zutun. Für die Datenbank-Gruppe nutzen Sie deshalb nur Benachrichtigungs-Trigger wie ntfy oder SMTP.

Option 3: Diun 4.34.0 meldet nur

Diun (Docker Image Update Notifier) ist seit dem 19. November 2026 in Version 4.34.0 aktuell. Diese Version führt unter anderem watchMode für die Auswahl der überwachten Tags ein. Die Lizenz ist MIT. Diun beobachtet Images und sagt Ihnen, wenn ein Update da ist. Pull und Neustart gehören nicht zu dem, was die Dokumentation beschreibt. Genau das macht es zum passenden Werkzeug für die Datenbank-Gruppe.

Dieses Compose-File schickt Meldungen an einen ntfy-Server. Ohne eigene Angabe nutzt Diun den öffentlichen Dienst https://ntfy.sh. Ein eigener Server ist besser, und ntfy für Push-Benachrichtigungen selbst hosten zeigt die Einrichtung.

services:
  diun:
    image: crazymax/diun:4.34.0
    container_name: diun
    command: serve
    restart: unless-stopped
    volumes:
      - ./data:/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - DIUN_WATCH_SCHEDULE=0 */6 * * *
      - DIUN_PROVIDERS_DOCKER=true
      - DIUN_NOTIF_NTFY_ENDPOINT=https://ntfy.example.com
      - DIUN_NOTIF_NTFY_TOPIC=docker-updates
      - DIUN_NOTIF_NTFY_TOKEN=${NTFY_TOKEN}

DIUN_WATCH_SCHEDULE hat keinen Standardwert. 0 */6 * * * prüft alle sechs Stunden, so wie im Beispiel der Dokumentation. Die Priorität der ntfy-Nachricht steht standardmäßig auf 3. Diun überwacht standardmäßig keinen Container, denn DIUN_PROVIDERS_DOCKER_WATCHBYDEFAULT steht auf false. Jeder Container braucht deshalb das Label diun.enable=true.

Bei einem festen Tag wie postgres:16.4 gibt es eine Falle. Ohne weitere Labels prüft Diun nur diesen einen Tag. Eine neue Version 16.5 erscheint aber als neuer Tag. Mit diun.watch_mode=all beobachtet Diun alle Tags des Images. Das bisherige diun.watch_repo=true funktioniert in 4.34 noch, erzeugt aber eine Warnung und soll ersetzt werden. diun.include_tags filtert sie mit regulären Ausdrücken, mehrere trennen Sie mit Semikolon:

services:
  db:
    image: postgres:16.4
    labels:
      - diun.enable=true
      - diun.watch_mode=all
      - diun.include_tags=^16\.[0-9]+$$

Das doppelte $$ ist Absicht. Compose macht aus $$ ein einfaches $; ein einzelnes $ am Ende dieses Ausdrucks bleibt ebenfalls erhalten, weil danach keine gültige Variablensyntax folgt. Das Verdoppeln ist hier also nicht nötig. Der Ausdruck passt dann auf 16.5, aber nicht auf 17.0 oder 16.5-alpine. Die Dokumentation mahnt beim Überwachen aller Repository-Tags zur Vorsicht wegen der Rate Limits von Docker Hub. Setzen Sie es deshalb nur dort, wo Sie feste Tags nutzen.

Statt ntfy geht auch E-Mail. Standard ist localhost auf Port 25 ohne SSL, das passt selten. Port und SSL hängen von Ihrem Mail-Anbieter ab:

      - DIUN_NOTIF_MAIL_HOST=smtp.example.com
      - DIUN_NOTIF_MAIL_PORT=465
      - DIUN_NOTIF_MAIL_SSL=true
      - DIUN_NOTIF_MAIL_USERNAME=diun@example.com
      - DIUN_NOTIF_MAIL_PASSWORD=${MAIL_PASSWORD}
      - DIUN_NOTIF_MAIL_FROM=diun@example.com
      - DIUN_NOTIF_MAIL_TO=admin@example.com

Starten Sie Diun und lesen Sie das Log:

docker compose up -d
docker compose logs --tail 30 diun

Diun prüft sofort beim Start, weil runOnStartup standardmäßig auf true steht. Eine Nachricht kommt dabei aber meist nicht. DIUN_WATCH_FIRSTCHECKNOTIF steht auf false, also meldet Diun ein Image bei der allerersten Prüfung nicht. Ein stiller erster Lauf ist deshalb normal. Wollen Sie den Kanal testen, setzen Sie die Variable einmal auf true, löschen den Ordner ./data und starten neu.

Welche Kombination passt zu einem VPS mit wenigen Stacks?

Für einen Server mit einigen Compose-Stacks empfehlen wir zwei Werkzeuge mit getrennten Aufgaben. Der Fork aktualisiert nachts die Frontends mit dem Watchtower-Label. Diun meldet alles andere per ntfy, die Datenbanken mit watch_mode=all und einem Tag-Filter. Kommt eine Meldung, folgen Sie dem Backup-Ablauf und ändern den Tag von Hand.

Wollen Sie eine Übersicht über alle Container im Browser, nehmen Sie WUD allein. Dann gilt: Benachrichtigungs-Trigger für alle Container, ein Docker-Trigger höchstens für die Frontends. Lassen Sie nie zwei Werkzeuge denselben Container aktualisieren. Sie würden sich gegenseitig Container neu erstellen, und im Log wäre nicht mehr klar, wer was getan hat.

Typische Fehler und ihre Ursachen

  • Im Log steht client version 1.25 is too old. Hier läuft noch das alte containrrr-Image gegen Docker 29. Wechseln Sie zum Fork oder testen Sie vorübergehend DOCKER_API_VERSION.
  • Der Fork läuft, aktualisiert aber nichts. WATCHTOWER_LABEL_ENABLE=true ist gesetzt, aber kein Container trägt das Label. Prüfen Sie es mit dem docker inspect-Befehl von oben.
  • Updates laufen zur falschen Uhrzeit. TZ fehlt, deshalb rechnet der Zeitplan in UTC.
  • WUD startet nicht. Es gibt keinen Administrator. Prüfen Sie WUD_AUTH_ADMIN_USER und WUD_AUTH_ADMIN_PASSWORD und ob die .env neben dem Compose-File liegt.
  • Diun schickt beim Start keine Nachricht. Das ist der Standard, weil die erste Prüfung eines Images nicht gemeldet wird.
  • Die Platte läuft voll. WATCHTOWER_CLEANUP fehlt, und jedes Update lässt ein altes Image zurück.

FAQ

Warum meldet Watchtower "client version 1.25 is too old"?

Das archivierte Image containrrr/watchtower spricht eine alte Docker-API. Docker Engine 29.0 verlangt mindestens API v1.44, ab 29.3 mindestens v1.40. Beide Grenzen liegen über 1.25. Nutzer berichten, dass DOCKER_API_VERSION=1.44 am alten Container unter Docker 29.0.x half. Dauerhaft lösen Sie das Problem mit dem gepflegten Fork nickfedor/watchtower, der die API-Version selbst aushandelt.

Kann ich containrrr/watchtower einfach durch nickfedor/watchtower ersetzen?

In den meisten Setups ja. Der Fork bindet den Docker-Socket genauso ein und nutzt dieselben Label-Namen wie com.centurylinklabs.watchtower.enable. Eine offizielle Migrationsanleitung gibt es nicht. Prüfen Sie deshalb jede Umgebungsvariable Ihrer alten Konfiguration gegen die Doku des Forks. Pinnen Sie den Tag 1.24.1 statt latest.

Soll ich Datenbank-Container automatisch aktualisieren lassen?

Nein. Datenbanken und Anwendungen mit Migrationen ändern beim Start ihre Daten. Danach passt das alte Image oft nicht mehr, und ein Zurück geht nur mit einem Backup von vorher. Lassen Sie sich diese Updates von Diun oder WUD melden. Sichern Sie dann Daten und Volumes und ändern Sie den festen Tag von Hand.

Ist es gefährlich, /var/run/docker.sock in einen Container einzubinden?

Ja, und alle hier genannten Werkzeuge tun es. Der Docker-Daemon läuft als root und erlaubt Bind-Mounts ohne Einschränkung. Wer den Socket erreicht, kann einen Container mit dem Wurzelverzeichnis des Hosts starten und hat damit praktisch Root-Rechte. Ein :ro am Mount schränkt die API nicht ein. Nutzen Sie nur gepflegte Images mit festen Tags und halten Sie Weboberflächen wie WUD vom Internet fern.

War dieser Artikel hilfreich?