API version 1.41 is not supported by this client: the minimum supported API version is 1.44

[imhansai]

sudo podman-mac-helper install
podman machine start
docker version

Client: Docker Engine - Community
 Version:           29.1.3
 API version:       1.52
 Go version:        go1.25.5
 Git commit:        f52814d454
 Built:             Fri Dec 12 14:45:37 2025
 OS/Arch:           darwin/arm64
 Context:           default

Server: linux/arm64/fedora-43
 Podman Engine:
  Version:          5.7.1
  APIVersion:       5.7.1
  Arch:             arm64
  BuildTime:        2025-12-09T08:00:00+08:00
  Experimental:     false
  GitCommit:        f845d14e941889ba4c071f35233d09b29d363c75
  GoVersion:        go1.25.4 X:nodwarf5
  KernelVersion:    6.17.7-300.fc43.aarch64
  MinAPIVersion:    4.0.0
  Os:               linux
 Conmon:
  Version:          conmon version 2.1.13, commit:
  Package:          conmon-2.1.13-2.fc43.aarch64
 OCI Runtime (crun):
  Version:          crun version 1.24
commit: 54693209039e5e04cbe3c8b1cd5fe2301219f0a1
rundir: /run/user/501/crun
spec: 1.0.0
+SYSTEMD +SELINUX +APPARMOR +CAP +SECCOMP +EBPF +CRIU +LIBKRUN +WASM:wasmedge +YAJL
  Package:          crun-1.24-1.fc43.aarch64
 Engine:
  Version:          5.7.1
  API version:      1.41 (minimum version 1.24)
  Go version:
  Git commit:
  Built:
  OS/Arch:          linux/arm64
  Experimental:

docker images

API version 1.41 is not supported by this client: the minimum supported API version is 1.44

What is the situation? How to solve it?

[afbjorklund]

Docker client v29 now requires Docker server v25, while Podman only supports 1.12-20.10 (API version 1.24-1.41)

See https://docs.docker.com/reference/api/engine/

https://docs.docker.com/engine/release-notes/29/#2900

So you need to either downgrade the docker client to an older version (v28), or use the podman client instead...

https://docs.docker.com/engine/install/binaries/#install-client-binaries-on-macos

podman images

[imhansai]

Docker client v29 now requires Docker server v25, while Podman only supports 1.12-20.10 (API version 1.24-1.41)

See https://docs.docker.com/reference/api/engine/

https://docs.docker.com/engine/release-notes/29/#2900

So you need to either downgrade the docker client to an older version (v28), or use the podman client instead...

https://docs.docker.com/engine/install/binaries/#install-client-binaries-on-macos

podman images

Thank you for your answer.

Based on the information you provided, I found an unconventional solution: using export DOCKER_API_VERSION=1.52 allows docker images to work correctly.

However, I noticed that:

This environment variable disables API version negotiation, so you should only use it if you must use a specific version of the API, or for debugging purposes.

Although it works correctly now, other errors might occur in some situations.

Therefore, the correct solution at the moment is to downgrade the Docker client.

Thank you again.

[afbjorklund]

The best option would probably be for Podman to bump from API version 1.41 to API version 1.44

But there could be some code changes involved, so that requires a separate issue to be opened...

• https://docs.docker.com/reference/api/engine/version-history/#v144-api-changes
• https://docs.docker.com/reference/api/engine/version-history/#v143-api-changes
• https://docs.docker.com/reference/api/engine/version-history/#v142-api-changes

Similar to this one: (from 1.40 to 1.41)

• Docker client API version negotation resolves 1.40 but creating a container with a certain image platform requires at least 1.41 although Podman does support it #14204

[afbjorklund]

Therefore, the correct solution at the moment is to downgrade the Docker client.

Docker Engine v25 has some LTS support, so that would be supported until 2027

https://github.com/moby/moby/blob/master/project/BRANCHES-AND-TAGS.md

But it will be a problem, especially for older Podman versions (before 5.7.x that is)

Since they are less likely to get such features backported, as they are End-Of-Life

[imhansai]

Thank you, let me know a lot. I wish Podman better and better.