Skip to content

docs: update Docker API version error FAQ for v2.15.1 #120

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

Merged
mbevc1 merged 2 commits into from
Apr 2, 2026
Merged

docs: update Docker API version error FAQ for v2.15.1 #120

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
38ede80
docs: update Docker API version error FAQ for CLI v2.15.1 auto-negoti…
mintlify[bot] Apr 2, 2026
6ec5825
Apply suggestion from @mbevc1
mbevc1 Apr 2, 2026
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
12 changes: 9 additions & 3 deletions troubleshooting/docker_api_version_error.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Docker API version error in GitHub Actions"
description: 'How to fix the "client version 1.47 is too new" error when running the Kosli CLI in GitHub Action workflows.'
description: 'How to fix the "client version 1.51 is too new" error when running the Kosli CLI with Docker operations.'
---

## Error
Expand All @@ -9,7 +9,11 @@ description: 'How to fix the "client version 1.47 is too new" error when running
Error response from daemon: client version 1.47 is too new. Maximum supported API version is 1.45
```

## Solution
<Info>
**Kosli CLI v2.15.1+:** This error is resolved automatically. The CLI now negotiates the Docker API version with the daemon, so it adapts to whatever Docker Engine version is available. Upgrade to v2.15.1 or later and no workaround is needed.
</Info>

## Solution for CLI versions before v2.15.1

Set the `DOCKER_API_VERSION` environment variable in your workflow:

Expand All @@ -20,4 +24,6 @@ env:

## Context

The latest Kosli CLI defaults to Docker API version 1.47, but GitHub Action workflows currently support a maximum of 1.45.
Prior to v2.15.1, the Kosli CLI defaulted to a fixed Docker API version (e.g., 1.47), which could be higher than what the Docker daemon on the host supports. This caused Docker operations (`--artifact-type docker`) to fail with a "client version is too new" error.

From v2.15.1 onwards, the CLI automatically negotiates the API version with the Docker daemon, eliminating this issue.