Skip to content

Commit 793d43d

Browse files
author
Misty Stanley-Jones
authored
Add info about CE and EE max API mismatch (docker#5910)
1 parent 28ccac2 commit 793d43d

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

‎develop/sdk/index.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,21 @@ You can specify the API version to use, in one of the following ways:
125125
or the
126126
[Python SDK documentation for `client`](https://docker-py.readthedocs.io/en/stable/client.html).
127127

128+
### Docker EE and CE API mismatch
129+
130+
If you use Docker EE in production, we recommend using Docker EE in development
131+
too. If you can't, such as when your developers use Docker for Mac or Docker for
132+
Windows and manually build and push images, then your developers need to configure
133+
their Docker clients to use the same version of the API reported by their Docker
134+
daemon. This prevents the developer from using a feature that is not yet supported
135+
on the daemon where the workload runs in production. You can do this one of two ways:
136+
137+
- Configure the Docker client to connect to an external daemon running Docker EE.
138+
You can use the `-H` flag on the `docker` command or set the `DOCKER_HOST`
139+
environment variable. The client uses the daemon's latest supported API version.
140+
- Configure the Docker client to use a specific API by setting the `DOCKER_API_VERSION`
141+
environment variable to the API version to use, such as `1.30`.
142+
128143
### API version matrix
129144

130145
Docker does not recommend running versions prior to 1.12, which means you

0 commit comments

Comments
 (0)