Watchtower Fehler „client version 1.25 is too old“: Mein schneller Fix

Neulich hatte ich mal wieder einen dieser Momente, in denen man zu spät merkt, dass irgendwas nicht stimmt. Ich habe am Nachmittag zufällig gesehen, dass mir Watchtower seit dem Vormittag im Minutentakt Notifications geschickt hat. Im Log stand genau dasselbe immer und immer wieder:

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

🧠 Die Ursache: Docker 29 setzt eine neuere API voraus

Im Netz habe ich dann gelesen, dass Docker ab Version 29 zwingend die API Version 1.44 oder neuer verlangt. Dadurch brechen plötzlich Tools, die noch auf älteren API-Versionen laufen – unter anderem Watchtower. Da ich am Vormittag Updates gemacht hatte, war ich natürlich auch unmittelbar davon betroffen.

Falls du prüfen möchtest, ob deine Docker-Installation bereits von den API-Änderungen betroffen ist, kannst du ganz einfach deine installierte Version abfragen:

docker --version

Watchtower selbst nutzt standardmäßig API Version 1.25. Und genau das führt zum Fehler.

Da das Projekt seit zwei Jahren kein Update mehr bekommen hat, war mir schnell klar: Da kommt nichts mehr.

🔧 Die schnelle Lösung: Eine Umgebungsvariable setzen

Der Fix ist glücklicherweise simpel und sofort umsetzbar.

Ich habe in meiner Docker-Compose-Datei einfach diese Umgebungsvariable hinzugefügt:

---
services:

  watchtower:
    image: containrrr/watchtower
    environment:
      - DOCKER_API_VERSION=1.44

Danach den Container neu gestartet – und plötzlich war wieder Ruhe!
Keine Notifications, keine Fehler im Log. Genau so will man das.

Watchtower zwingt man mit dieser Variable, die neuere API zu verwenden, die Docker 29 voraussetzt. Damit funktioniert die Kommunikation wieder reibungslos.

🚀 Eine mögliche Alternative

Weil das Originalprojekt praktisch eingefroren ist, habe ich auch direkt nach einem aktiven Fork gesucht. Dabei bin ich auf dieses Repository gestoßen:

Der Entwickler pflegt das Tool weiter und veröffentlicht auch Images.
Wenn du also langfristig etwas Stabileres möchtest, probier gern mal diesen Container aus:

nickfedor/watchtower:latest

Ich teste den Fork demnächst auch mal. Vielleicht ist das ja die modernere und zuverlässigere Variante für die Zukunft.

👥 Techniverse Community

Lust auf Austausch rund um Matrix, Selfhosting und andere smarte IT-Lösungen?
In der Techniverse Community triffst du Gleichgesinnte, kannst Fragen stellen oder einfach nerdigen Talk genießen. 🚀

👉 Jetzt der Gruppe auf Matrix beitreten
~ Direkte Raumadresse: #community:techniverse.net

👉 Für lockere Gespräche abseits der Kernthemen komm in den Talkraum
~ Direkte Raumadresse: #talk:techniverse.net

Wir freuen uns, wenn du dabei bist!