NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #569 most downloaded on PyPI
Python library for throwaway instances of anything that can run in a Docker container
Last release 2 months ago
24 Jul 2026
Ships fairly regularly
a new release about every 5 weeks
Some releases are documented
notes for 33 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
10 years old
72 releases · first in 2016
cratedb: add CrateDB community module
main: make legacy imports available with deprecation notice
One column per quarter.
mongodb: Use wait strategy instead of deprecated wait_for_logs
ExecWaitStrategy instead of deprecated wait_container_is_ready (#1016) (4c53b89), closes #874azurite: use HttpWaitStrategy instead of deprecated wait_container_is_ready ( #1003 ) ( 9fe6b07 ), closes #874
clickhouse: add HttpWaitStrategy instead of deprecated wait_container_is_ready
HttpWaitStrategy instead of deprecated wait_container_is_ready (#962) (8034541)kafka: allow configurable listener name and security protocol
Allow passing in a custom wait strategy string in MySQL, Cassandra, Kafka and Trino
Add ExecWaitStrategy and migrate Postgres from deprecated decorator
do not require consumer of library to state nonsupport for py4
trino: Remove deprecated class and decorator from Trino container
waiting_for to Self. (#890) (fe941b1)azurite: Enhance connection string generation for network and local access
main: New Testcontainers Python Docs Site
core: Protocol support for container port bind and expose
Change env var disabling OpenSearch security plugin
milvus healthcheck: use correct requests errors
compose: support for setting profiles
core: Reorganize core tests and improve
generic: Update the FastAPI install on genric module doctest samples
Adding support for Cassandra and Scylla
vhost as parameter to RabbitMqContainer (#656) (fa2081a)Add container Trino (#642) (49ce5a5), closes #641
network: Now able to use Network without context, and has labels to be automatically cleaned up
core: allow custom dockerfile path for image build and bypassing build cache (#615) (ead0f79), closes #610
core: Image build (Dockerfile support)
k3s: add configuration parameter for disabling cgroup mount to avoid "unable to apply cgroup configuration"
added types to exec & tc_properties_get_tc_host
core: add empty _configure to DockerContainer
labels: Add common testcontainers labels
sqlalchemy in DB extras. Add default wait timeout for wait_for_logs (#525) (fefb9d0)missing typing-extensions dependency (#534) (ef86d15), closes #533
core: Improve typing for common container usage scenarios
core: env vars not being respected due to constructor call (#524) (4872ea5), closes #521
Nothing published for this version
client: Add custom User-Agent in Docker client as tc-python/<version>
arangodb: tests to pass on ARM CPUs - change default image to 3.11.x where ARM image is published
DockerContainer.get_logs (#487) (cd72f68)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
> Due to some issues with the release automation, you'll find this release under 4.1.1
postgres: Remove SqlAlchemy dependency from postgres container
The breaking changes are the ones we were able to easily track. If you spot any new issues between 3.7.1 and 4.0.0, please do report it and we'll do o…
The breaking changes are the ones we were able to easily track. If you spot any new issues between 3.7.1 and 4.0.0, please do report it and we'll do our best to fix everything. The release is now
Some kudos from @totallyzen to folks who helped a great deal in starting things again:
tc.host and de-prioritise docker:dind (#388)tc.host and de-prioritise docker:dind (#388) (2db8e6d)pre-commit as a dev dependency to simplify local dev and CI (#438) (1223583)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix host identification on Windows
Fix host identification on Windows
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →