Skip to content

fix: pin Watchtower DOCKER_API_VERSION for Docker Engine 28+ #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
taobojlen wants to merge 1 commit into from
Closed

fix: pin Watchtower DOCKER_API_VERSION for Docker Engine 28+ #10

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docker-compose.override.example.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,4 @@ services:
- WATCHTOWER_LABEL_ENABLE=true # ONLY update opted-in containers — never db
- WATCHTOWER_POLL_INTERVAL=300 # poll GHCR every 5 min
- WATCHTOWER_CLEANUP=true # delete old images after updating
- DOCKER_API_VERSION=1.44 # watchtower 1.7.1's SDK defaults to 1.25, too old for Docker Engine 28+

@cubic-dev-ai cubic-dev-ai Bot Jul 24, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: This override's comment misidentifies the affected daemon version, and the unconditional pin introduces a compatibility regression for Docker Engine 24 and older because those daemons reject client API 1.44 as too new. Correct the version rationale and either preserve negotiation or document/enforce a Docker Engine 25+ prerequisite for this example.

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At docker-compose.override.example.yaml, line 25:

<comment>This override's comment misidentifies the affected daemon version, and the unconditional pin introduces a compatibility regression for Docker Engine 24 and older because those daemons reject client API 1.44 as too new. Correct the version rationale and either preserve negotiation or document/enforce a Docker Engine 25+ prerequisite for this example.</comment>

<file context>
@@ -22,3 +22,4 @@ services:
       - WATCHTOWER_LABEL_ENABLE=true   # ONLY update opted-in containers — never db
       - WATCHTOWER_POLL_INTERVAL=300   # poll GHCR every 5 min
       - WATCHTOWER_CLEANUP=true        # delete old images after updating
+      - DOCKER_API_VERSION=1.44        # watchtower 1.7.1's SDK defaults to 1.25, too old for Docker Engine 28+
</file context>

Loading