NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #214 most downloaded on PyPI
A Python library for the Docker Engine API.
Last release 2 months ago
09 Jul 2026
Ships unpredictably
gaps range from 1 weeks to 2.1 years
Nearly every release is documented
notes for 57 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
66 releases · first in 2016
List of PRs / issues for this release
List of PRs / issues for this release
1.26 (Engine 1.13.1+)upgrade_plugin method to the APIClient classupgrade method to the Plugin classservice_logs method to the APIClient classlogs method to the Service classdf method to APIClient and DockerClientinit and init_path parameters in HostConfig
and DockerClient.containers.runhostname parameter in ContainerSpec and
DockerClient.service.create8000-8010:80)TypeErrorevents method in APIClient and DockerClient
would not respect custom headers set in config.jsonOne column per quarter.
List of PRs / issues for this release
List of PRs / issues for this release
APIClient: prune_containers, prune_images, prune_networks,
prune_volumesDockerClient: containers.prune, images.prune, networks.prune,
volumes.pruneAPIClient: configure_plugin, create_plugin, disable_plugin,
enable_plugin, inspect_plugin, pull_plugin, plugins,
plugin_privileges, push_plugin, remove_pluginDockerClient: plugins.create, plugins.get, plugins.install,
plugins.list, and the Plugin model.APIClient: create_secret, inspect_secret, remove_secret,
secretsDockerClient: secret.create, secret.get, secret.list and
the Secret model.secrets parameter to ContainerSpec. Each item in the secrets
list must be a docker.types.SecretReference instance.cache_from in APIClient.build and
DockerClient.images.build.auto_remove and storage_opt in
APIClient.create_host_config and DockerClient.containers.runstop_timeout in APIClient.create_container and
DockerClient.containers.runforce parameter in APIClient.remove_volume and
Volume.removemax_failure_ratio and monitor in UpdateConfigforce_update in TaskTemplatename parameter optional in APIClient.create_volume and
DockerClient.volumes.createAttributeError.DockerClient.swarm.init method to
take into account arguments passed to it.Image.tag now correctly returns a boolean value upon completion.volumes in
DockerClient.containers.runDockerClient.image.build wouldn't return an Image
object even when the build was successfulList of PRs / issues for this release
List of PRs / issues for this release
docker-py package is
installed in order to prevent obscure naming conflicts when both
packages co-exist.filters parameter to APIClient.networks.DockerClient are now hashable.DockerClient
would raise a TypeError exception.mode parameter in create_service is now properly converted to
a valid data type for the Engine API. Use ServiceMode for advanced
configurations.APIClient.events stream would sometimes raise
an exception when a container is stopped or restarted.List of PRs / issues for this release
List of PRs / issues for this release
Mount.parse_mount_string would never set the read_only
parameter on the resulting Mount.Mount.parse_mount_string would incorrectly mark host
binds as being of volume type.endpoint_config in create_service and update_service has been deprecated in favor of endpoint_spec
List of PRs / issues for this release
docker.Client has been renamed to docker.APIClientdocker.from_env now creates a DockerClient instance instead of an
APIClient instance.APIClient.startpip package is now docker (was: docker-py). New
versions of this library will only be published as docker from now on.docker.ssladapter is now docker.transport.ssladapterdocker.auth and docker.utils.portsdocker.utils.types has been moved to docker.typescreate_host_config, create_ipam_pool and create_ipam_config have been
removed from docker.utils. They have been replaced by the following classes
in docker.types: HostConfig, IPAMPool and IPAMCOnfig.docker.DockerClient. See the
README and documentation for more information.update_node method in APIClient.remove_node method in APIClient.restart_policy in update_container.labels and shmsize in build.attachable in create_networkhealthcheck in create_container.isolation in HostConfig.pid_mode in HostConfig (now supports arbitrary
values for API version >= 1.24).options in IPAMConfigHealthCheck class to docker.types to be used in
create_container.EndpointSpec class to docker.types to be used in
create_service and update_service.build if the client used a credentials store.build.build on Windows.networks in create_service and
update_service wouldn't be properly converted for the engine.endpoint_config in create_service and
update_service would be ignored.endpoint_config in create_service and update_service has been
deprecated in favor of endpoint_specconstraints in a TaskTemplate object wouldn't be
properly converted for the engine.env in ContainerSpec
would provoke an APIError when sent to the engine.env_file containing empty lines in
create_containerwould raise an exception.detach was being ignored by exec_start.Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →