0.25.0

Breaking Changes

• Drop Python 3.9 support and add Python 3.14 support, updating dependencies such as aiohttp (minimum 3.8 to 3.10) and async-timeout (minimum to 5.0) for stdlib TaskGroup and timeout compatibility in Python 3.11+ (#976)
• Replace **kwargs with explicit parameters in DockerContainer.{stop,restart,kill,delete}() methods, accepting t for server-side stop timeout and timeout for client-side request timeouts for consistency with other methods covered in the previous PRs #983 and #990; since this is a BREAKING CHANGE for those who have used the timeout argument for the DockerContainer.restart() method calls, the users should replace it with t to keep the intended semantics (#991)

Bug Fixes

• Fix issue authenticating against private registries where the X-Registry-Auth header would require URL-safe substitutions. (#941)

New Features

• Add support for Docker context endpoints with TLS, reading configuration from ~/.docker/contexts/ and respecting DOCKER_CONTEXT environment variable and SkipTLSVerify option. (#811)
• Add SSH protocol support for secure connections to remote Docker instances via "ssh://" URLs with mandatory host key verification (#982)
• Introduce the client-level timeout configuration which becomes the base timeout configuration while still allowing legacy individual per-API timeouts and merging it into the base timeout. Now setting individual float (total) timeout per-API call is HIGHLY DISCOURAGED in favor of composable timeouts via stdlib's asyncio.timeout() async context manager. (#983)

Miscellaneous

• Improve the CI workflows to expand the test matrix for aiohttp 3.10/3.13 releases and let tests use the prebuilt artifact to ensure consistency with the release (#980)
• Isolate the docker instance for swarm and service tests via a docker-in-docker compose stack to avoid affecting the user environment (#981)
• Apply the default cooldown period (7 days) to the dependabot configuration (#984)

0.24.0

Features

• Added Python 3.13 support (#927)
• Added timeout parameter for push method (#929)

Bugfixes

• Fix DockerImages.build(), DockerImages.pull(), DockerImages.push() methods' incorrect return type declarations. (#909)

Deprecations and Removals

• Removed Python 3.8 support as it has reached end of life. (#924)

0.23.0

Features

• Introduce a sentinel value to _do_query() and its friend methods to allow configuring per-request infinite timeouts instead of always falling back to the session-level default timeout when setting the timeout argument to None, and add the timeout arguments to image-related API wrappers (#900)

0.22.2

Bugfixes

• Use TYPE_CHECKING flag to avoid importing from typing_extensions at run time (#876)

0.22.1

Bugfixes

• Fix a missing removal of the legacy AsyncCM interface usage and update type annotations to avoid this in the future (#874)

0.22.0

NOTICE: This release drops support for Python 3.7 and older. Please upgrade your Python version or keep using prior releases.

Features

• Adds the force parameter to DockerVolume.delete() (#690)
• Migrate from setuptools to hatch. To install the package and all dependencies, use "pip install .[dev,doc]". (#848)

Bugfixes

• Support additional parameters in swarm init (#323)
• Fixes unittests that don't run locally due to deprecations in later versions of Docker. Tested with 26.00, v1.45. (#849)
• Fix never-awaited coroutines of _AsyncCM to close when handling errors (#861)

Misc

• #850

0.22.0a1

Features

• Add support for filters when listing networks.
  Add support for filters when listing volumes.
  Add get option for fetching volumes by name or id. (#623)

Improved Documentation

• Update the documentation examples to use the modern asyncio.run() pattern and initialize aiodocker.Docker() instance inside async functions where there is a valid running event loop (#837)

Deprecations and Removals

• Starting container with non-empty request body was deprecated since API v1.22 and removed in v1.24 (#660)

Misc

• #621, #748

aiodocker 0.18.0 release

Features

• Improve the error text message if cannot connect to docker engine. (#411)
• Implement docker exec protocol. (#415)
• Implement container commit, pause and unpause functionality. (#418)
• Implement auto-versioning of the docker API by default. (#419)

v0.14.0

• Removal: docker.images.get has been renamed to docker.images.inspect, remove support for Docker 17.06
• Feature: Add support for docker save and load api methods
• Feature: Add support for Docker 17.12.1 and 18.03.1
• Fix: fix to parse response of docker load method as a json stream
• Fix: don't remove non-newline whitespace from multiplexed lines
• Fix: Handle responses with 0 or missing Content-Length
• Fix: docker_context.tar error

v0.13.0

• Feature: Add support for docker save and load api methods
• Pass params to docker events