@@ -38,29 +38,29 @@ machine running Docker Desktop:
3838$ docker version
3939
4040Client: Docker Engine - Community
41- Version: 23.0.3
42- API version: 1.42
43- Go version: go1.19.7
44- Git commit: 3e7cbfd
45- Built: Tue Apr 4 22:05:41 2023
46- OS/Arch: darwin/amd64
47- Context: default
41+ Version: 28.5.1
42+ API version: 1.51
43+ Go version: go1.24.8
44+ Git commit: e180ab8
45+ Built: Wed Oct 8 12:16:17 2025
46+ OS/Arch: darwin/arm64
47+ Context: remote-test-server
4848
4949Server: Docker Desktop 4.19.0 (12345)
5050 Engine:
51- Version: 23.0.3
52- API version: 1.42 (minimum version 1.12 )
53- Go version: go1.19.7
54- Git commit: 59118bf
55- Built: Tue Apr 4 22:05:41 2023
51+ Version: 27.5.1
52+ API version: 1.47 (minimum version 1.24 )
53+ Go version: go1.22.11
54+ Git commit: 4c9b3b0
55+ Built: Wed Jan 22 13:41:24 2025
5656 OS/Arch: linux/amd64
57- Experimental: false
57+ Experimental: true
5858 containerd:
59- Version: 1.6.20
60- GitCommit: 2806fc1057397dbaeefbea0e4e17bddfbd388f38
59+ Version: v1.7.25
60+ GitCommit: bcc810d6b9066471b0b6fa75f557a15a1cbf31bb
6161 runc:
62- Version: 1.1.5
63- GitCommit: v1.1.5 -0-gf19387a
62+ Version: 1.2.4
63+ GitCommit: v1.2.4 -0-g6c52b3f
6464 docker-init:
6565 Version: 0.19.0
6666 GitCommit: de40ad0
@@ -83,31 +83,32 @@ remote-test-server
8383$ docker version
8484
8585Client: Docker Engine - Community
86- Version: 23.0.3
87- API version: 1.40 (downgraded from 1.42)
88- Go version: go1.19.7
89- Git commit: 3e7cbfd
90- Built: Tue Apr 4 22:05:41 2023
91- OS/Arch: darwin/amd64
86+ Version: 28.5.1
87+ API version: 1.51
88+ Go version: go1.24.8
89+ Git commit: e180ab8
90+ Built: Wed Oct 8 12:16:17 2025
91+ OS/Arch: darwin/arm64
9292 Context: remote-test-server
9393
9494Server: Docker Engine - Community
9595 Engine:
96- Version: 19.03.8
97- API version: 1.40 (minimum version 1.12 )
98- Go version: go1.12.17
99- Git commit: afacb8b
100- Built: Wed Mar 11 01:29:16 2020
96+ Version: 27.5.1
97+ API version: 1.47 (minimum version 1.24 )
98+ Go version: go1.22.11
99+ Git commit: 4c9b3b0
100+ Built: Wed Jan 22 13:41:24 2025
101101 OS/Arch: linux/amd64
102+ Experimental: true
102103 containerd:
103- Version: v1.2.13
104- GitCommit: 7ad184331fa3e55e52b890ea95e65ba581ae3429
104+ Version: v1.7.25
105+ GitCommit: bcc810d6b9066471b0b6fa75f557a15a1cbf31bb
105106 runc:
106- Version: 1.0.0-rc10
107- GitCommit: dc9208a3303feef5b3839f4323d9beb36df0a9dd
107+ Version: 1.2.4
108+ GitCommit: v1.2.4-0-g6c52b3f
108109 docker-init:
109- Version: 0.18 .0
110- GitCommit: fec3683
110+ Version: 0.19 .0
111+ GitCommit: de40ad0
111112```
112113
113114### API version and version negotiation
@@ -117,14 +118,14 @@ CLI is connecting with. When connecting with the Docker Engine, the Docker CLI
117118and Docker Engine perform API version negotiation, and select the highest API
118119version that is supported by both the Docker CLI and the Docker Engine.
119120
120- For example, if the CLI is connecting with Docker Engine version 19.03 , it downgrades
121- to API version 1.40 (refer to the [ API version matrix] ( https://docs.docker.com/reference/api/engine/#api-version-matrix )
121+ For example, if the CLI is connecting with Docker Engine version 27.5 , it downgrades
122+ to API version 1.47 (refer to the [ API version matrix] ( https://docs.docker.com/reference/api/engine/#api-version-matrix )
122123to learn about the supported API versions for Docker Engine):
123124
124125``` console
125126$ docker version --format ' {{.Client.APIVersion}}'
126127
127- 1.40
128+ 1.47
128129```
129130
130131Be aware that API version can also be overridden using the ` DOCKER_API_VERSION `
@@ -135,14 +136,14 @@ variable removes the override, and re-enables API version negotiation:
135136
136137``` console
137138$ env | grep DOCKER_API_VERSION
138- DOCKER_API_VERSION=1.39
139+ DOCKER_API_VERSION=1.50
139140
140141$ docker version --format ' {{.Client.APIVersion}}'
141- 1.39
142+ 1.50
142143
143144$ unset DOCKER_API_VERSION
144145$ docker version --format ' {{.Client.APIVersion}}'
145- 1.42
146+ 1.51
146147```
147148
148149## Examples
@@ -159,7 +160,7 @@ page for details of the format.
159160``` console
160161$ docker version --format ' {{.Server.Version}}'
161162
162- 23.0.3
163+ 28.5.1
163164```
164165
165166### Get the client API version
@@ -169,7 +170,7 @@ The following example prints the API version that is used by the client:
169170``` console
170171$ docker version --format ' {{.Client.APIVersion}}'
171172
172- 1.42
173+ 1.51
173174```
174175
175176The version shown is the API version that is negotiated between the client
@@ -181,5 +182,5 @@ above for more information.
181182``` console
182183$ docker version --format ' {{json .}}'
183184
184- {"Client":"Version":"23.0.3 ","ApiVersion":"1.42 ", ...}
185+ {"Client":"Version":"28.5.1 ","ApiVersion":"1.51 ", ...}
185186```
0 commit comments