Skip to content

fix: add optional Watchtower Docker API override for Docker 29#80

Merged
ZeroPointSix merged 10 commits into
mainfrom
fix/issue-79-watchtower-api-version
Jun 7, 2026
Merged

fix: add optional Watchtower Docker API override for Docker 29#80
ZeroPointSix merged 10 commits into
mainfrom
fix/issue-79-watchtower-api-version

Conversation

@ZeroPointSix

@ZeroPointSix ZeroPointSix commented Jun 7, 2026

Copy link
Copy Markdown
Owner

Summary

  • Wire DOCKER_API_VERSION=${WATCHTOWER_DOCKER_API_VERSION:-} into the bundled Watchtower service so Docker API overrides are available without disabling negotiation by default.
  • Document WATCHTOWER_DOCKER_API_VERSION=1.44 as an opt-in workaround for Docker 29.0-29.2 client version ... too old failures, with notes for older Docker Engine users to leave it unset or choose a supported API version.
  • Add compose/README contract tests so the Watchtower override stays optional and does not regress back to a forced default API version.

Context

Watchtower's historical Docker client API default can be lower than the Docker Engine 29.0-29.2 minimum, which can produce client version 1.25 is too old. Minimum supported API version is 1.44 and make the app report that it cannot connect to http://watchtower:8080.

Docker's DOCKER_API_VERSION override disables API version negotiation when set to a non-empty value, so this PR now leaves the override empty by default and documents WATCHTOWER_DOCKER_API_VERSION=1.44 as the targeted workaround for affected Docker 29 deployments.

Closes #79.

Testing

  • Not run locally: this workspace cannot clone or download the repository directly from GitHub (CONNECT tunnel failed, response 403). Verified the changed files through the GitHub connector and added/updated tests/test_watchtower_compose_contract.py for CI.

@ZeroPointSix ZeroPointSix changed the title fix: set Watchtower Docker API version for Docker 29 fix: add optional Watchtower Docker API override for Docker 29 Jun 7, 2026
@sonarqubecloud

sonarqubecloud Bot commented Jun 7, 2026

Copy link
Copy Markdown

@ZeroPointSix ZeroPointSix merged commit d1086f7 into main Jun 7, 2026
7 checks passed
ZeroPointSix added a commit that referenced this pull request Jun 7, 2026
Revert the changes from PR #80 so main returns to the pre-review state.

Requested by maintainer: wait for human review before merging issue #79 fixes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

bug: 无法连接 Watchtower (http://watchtower:8080) 容器自带版本过低且基本无法自动启动

1 participant