[🐛 Bug]: DOCKER_API_VERSION 1.40 is not supporting

[janasrikanth]

What happened?

We started using selenium grid, when we try running tests we are getting error "unable to list images for Reference client version 1.41 is too new. Maximum supported API version is 1.40"

We are using Oracle Linux 7 and supported docker version is docker-cli-19.03.11.ol-5.el7.x86_64.
reference link : https://yum.oracle.com/repo/OracleLinux/OL7/addons/x86_64/index.html
Tried adding DOCKER_API_VERSION=1.40 in env variables in docker compose but it didn't work.

Command used to start Selenium Grid with Docker (or Kubernetes)

version: '3'
services:
  selenium-grid:
    image: "selenium/standalone-docker:4.35.0-20250808"
    container_name: selenium-grid
    privileged: true
    volumes:
       - '/test/Grid/config/config.toml:/opt/selenium/docker.toml'
       - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - SE_BROWSER_ARGS_DISABLE_DSHM=--disable-dev-shm-usage
      - SE_SESSION_REQUEST_TIMEOUT=600
      - SE_SESSION_RETRY_INTERVAL=2
      - SE_START_VNC=false
      - SE_VNC_NO_PASSWORD=true
      - SE_NODE_MAX_SESSIONS=8
      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
      - SE_ENABLE_TRACING=true
    ports:
      - "4444:4444"

Relevant log output

unable to list images for Reference client version 1.41 is too new. Maximum supported API version is 1.40

Operating System

"Oracle Linux Server 7.9

Docker Selenium version (image tag)

4.35.0-20250808

Selenium Grid chart version (chart version)

No response

[github-actions]

@janasrikanth, thank you for creating this issue. We will troubleshoot it as soon as we can.

---

Info for maintainers

Triage this issue by using labels.

If information is missing, add a helpful comment and then I-issue-template label.

If the issue is a question, add the I-question label.

If the issue is valid but there is no time to troubleshoot it, consider adding the help wanted label.

If the issue requires changes or fixes from an external project (e.g., ChromeDriver, GeckoDriver, MSEdgeDriver, W3C), add the applicable G-* label, and it will provide the correct link and auto-close the issue.

After troubleshooting the issue, please add the R-awaiting answer label.

Thank you!

[VietND96]

Is docker-cli-19.03.11.ol-5.el7.x86_64 the maximum version that Oracle Linux 7 supports? If no, can it be upgraded a little bit?
Follow https://docs.docker.com/reference/api/engine/, Docker Engine 20.10 can be used with a maximum of API 1.41
I believe we could not downgrade the API version in a new release

[janasrikanth]

Hi @VietND96
Thanks for the response.

docker-cli-19.03.11 is latest available for Oracle linux 7

see https://yum.oracle.com/repo/OracleLinux/OL7/addons/x86_64/index.html

[janasrikanth]

Is there any old selenium-standalone-docker images which support DOCKER_API_VERSION 1.40 and Grid ?

[VietND96]

Ok, thanks for your info. Let me check on this, to expand the range of support (in this case is using API v1.40), it needs to be done in Grid core. And this version was used from the first version of Selenium Grid v4

[janasrikanth]

@VietND96 you mean from the beginning Grid core was using DOCKER_API_VERSION=1.41 ?

[janasrikanth]

Please check the possible ways to fix this issue.

[VietND96]

https://github.com/SeleniumHQ/selenium/blob/d3cef1abcf7652787655aae92f97b1f9ef6fc70e/java/src/org/openqa/selenium/docker/v1_41/V141Docker.java#L37

@diemol, what do you think here? Do we need to support a dynamic input?
Trade-off is by passing the checks but not sure functions might work fully, since when asking GPT gap between Docker API v1.40 and v1.41, major thing is
POST /containers/create now accepts a platform query parameter in the form os[/arch[/variant]] Engine API version history | Docker Docs, this help in images now aday support both amd64 or arm64

[janasrikanth]

Hi @diemol
Can you please look into this

[diemol]

@janasrikanth, why can't you upgrade to Docker API 1.41? This is the first time in almost 4 years someone has requested a lower API version.

[janasrikanth]

Hi @diemol

Hi @VietND96 Thanks for the response.

docker-cli-19.03.11 is latest available for Oracle linux 7

see https://yum.oracle.com/repo/OracleLinux/OL7/addons/x86_64/index.html

if you check this, we cannot upgrade docker as OL-7 supports till docker 19.03.x (api-1.40)

[diemol]

@janasrikanth, why can't you ask them to support the 1.41 API? I don't understand why we need to downgrade.

[janasrikanth]

@janasrikanth, why can't you ask them to support the 1.41 API? I don't understand why we need to downgrade.

@diemol you mean to ask oracle team ?

[diemol]

Yes.