Repository navigation
Releases
4.17.0
What's Changed
Thanks to everyone who contributed and shared their feedback 🤜🤛.
The NuGet packages for this release have been attested for supply chain security using actions/attest. This confirms the integrity and provenance of the artifacts and helps ensure they can be trusted: #68254162.
⚠️ Breaking Changes
- fix: Create a connection string provider for each container (#1800) @HofmeisterAn
🚀 Features
- fix: Remove regular expression match timeouts (#1820) @HofmeisterAn
- feat: Add Chroma module (#1784) @Laurianti, @HofmeisterAn
- feat: Add ExecScriptAsync overload that accepts an encoding (#1805) @NikolaVetnic, @HofmeisterAn
- feat: Add MongoDB Atlas Local module (#1780) @lukasvosyka, @HofmeisterAn
- feat: Add Vault module (#1801) @ferhatblnk, @HofmeisterAn
🐛 Bug Fixes
- fix: Remove regular expression match timeouts (#1820) @HofmeisterAn
- fix: Skip host ports that are already forwarded (#1818) @HofmeisterAn
- fix: Run the module startup script after it has been copied completely (#1810) @HofmeisterAn
- fix: Keep the query string in the HTTP wait strategy path (#1807) @johnkaram02, @HofmeisterAn
- fix: Create a connection string provider for each container (#1800) @HofmeisterAn
- fix: Handle unpublished ports and ports mapped for multiple protocols (#1799) @HofmeisterAn
- fix: Stop evaluating wait strategies after a timeout and report cancellation (#1798) @HofmeisterAn
- fix: Search Docker registry credentials in order and stop at the first match (#1796) @HofmeisterAn
- fix: Stop reading from a closed Resource Reaper connection (#1794) @HofmeisterAn
- fix: Use a unique tar archive for each Docker image build (#1793) @HofmeisterAn
- fix: Align root and wildcard patterns in Docker ignore files with Docker (#1792) @HofmeisterAn
📖 Documentation
- docs: Add the default configuration to the module documentation (#1813) @HofmeisterAn
- docs: Document the default configuration of the modules (#1812) @HofmeisterAn
🧹 Housekeeping
- chore: Bump .NET SDK to 10.0.400 (#1822) @HofmeisterAn
- chore: Generate regular expressions at compile time (#1821) @HofmeisterAn
- chore: Resolve SonarCloud maintainability issues (#1814) @HofmeisterAn
- chore: Do not use PLINQ to create the ignore patterns (#1797) @HofmeisterAn
- chore: Remove redundant code from the Resource Reaper (#1795) @HofmeisterAn
- feat: Prepare next release cycle (4.17.0) (#1791) @HofmeisterAn
📦 Dependency Updates
- chore(deps): Bump the actions group with 10 updates (#1808) @dependabot[bot]
4.16.0
What's Changed
Huge thanks to everyone for your contributions and feedback 🧡.
The NuGet packages for this release have been attested for supply chain security using actions/attest. This confirms the integrity and provenance of the artifacts and helps ensure they can be trusted: #54051351.
🚀 Features
- feat: Add common WithSsl builder API and support it in Azurite (#1788) @aleksandarMilev, @HofmeisterAn
- feat: Add BuildKit support for image builds via sidecar container (#1761) @george-petrakis, @HofmeisterAn
- feat(Elasticsearch): Add OTLP and certificate support (#1774) @HofmeisterAn
🐛 Bug Fixes
- fix(PostgreSql): Support SSL with Alpine images and non-root users (#1790) @HofmeisterAn
- fix: Do not pull base image with unresolved platform variable (#1787) @HofmeisterAn
- fix(Kafka): Default to KRaft for Confluent Platform 8.x images (#1775) @arnelirobles, @HofmeisterAn
- fix(Kafka): Drop the trailing comma from advertised listeners (#1772) @arnelirobles, @HofmeisterAn
- fix: Prevent Docker ignore patterns from matching path prefixes (#1768) @Benziza, @HofmeisterAn
📖 Documentation
- docs: Complete builder API tables and align heading casing (#1778) @HofmeisterAn
- docs: Explain how builder configurations combine (#1770) @arnelirobles, @HofmeisterAn
🧹 Housekeeping
- fix: Regenerate expired test certificates (#1786) @zcsizmadia
- chore: Resolve Sonar findings (#1776) @HofmeisterAn
- chore: Remove Minio module (#1769) @HofmeisterAn
- chore: Publish NuGet packages with Trusted Publishing (OIDC) (#1763) @HofmeisterAn
- feat: Prepare next release cycle (4.16.0) (#1762) @HofmeisterAn
📦 Dependency Updates
- chore(deps): Bump the actions group with 5 updates (#1781) @dependabot[bot]
4.15.0
What's Changed
The NuGet packages for this release have been attested for supply chain security using actions/attest. This confirms the integrity and provenance of the artifacts and helps ensure they can be trusted: #45594466.
🚀 Features
- feat: Add options to the Docker Compose up and down command (#1759) @HofmeisterAn
- feat: Add QuestDB module (#1618) @FortuneN, @HofmeisterAn
- feat: Add Compose support (#1750) @HofmeisterAn
- fix(Couchbase): Treat an already provisioned cluster as configured (#1736) @arnelirobles, @HofmeisterAn
- feat: Retry transient Docker image pull failures (#1734) @thomhurst, @HofmeisterAn
- chore(deps): Split Dependabot NuGet jobs and bump test dependencies (#1746) @HofmeisterAn
- feat(MongoDb): Resolve the MongoDb shell file path once (#1745) @HofmeisterAn
🐛 Bug Fixes
- fix: Detach from the container output before stopping or removing it (#1755) @HofmeisterAn
- fix(GCloud): Bump test image version (#1752) @HofmeisterAn
📖 Documentation
- docs: Update CONTRIBUTING.md (#1744) @HofmeisterAn
🧹 Housekeeping
- chore: Improve null check, test typing, and IDE settings (#1757) @HofmeisterAn
- fix(GCloud): Bump test image version (#1752) @HofmeisterAn
- chore: Resolve Sonar findings (#1751) @HofmeisterAn
- chore(deps): Revert Dependabot NuGet jobs (#1748) @HofmeisterAn
- feat: Prepare next release cycle (4.15.0) (#1742) @HofmeisterAn
📦 Dependency Updates
- chore(deps): Bump mkdocs-material from 9.7.2 to 9.7.7 (#1758) @dependabot[bot]
- chore(deps): Bump the actions group with 5 updates (#1754) @dependabot[bot]
- chore(deps): Bump the actions group across 1 directory with 7 updates (#1747) @dependabot[bot]
- chore(deps): Revert Dependabot NuGet jobs (#1748) @HofmeisterAn
- chore(deps): Split Dependabot NuGet jobs and bump test dependencies (#1746) @HofmeisterAn
4.14.0
What's Changed
I published this version because several developers asked for a release addressing the SSH.NET vulnerability. As an interim fix, you can also bump the transitive dependency, which should work fine.
Unfortunately, I had to run the release CI pipeline twice (1, 2). The change #1725 introduced a regression that caused the pipeline to attempt to publish the Cake build project, which correctly failed (partially published).
The NuGet packages for this release have been attested for supply chain security using actions/attest. This confirms the integrity and provenance of the artifacts and helps ensure they can be trusted: #40693051.
🚀 Features
- feat: Add possibility to select MSSQL database (instead of master) (#1737) @0xced, @HofmeisterAn
- feat: Add Mailpit module (#1727) @0xced, @feslima, @HofmeisterAn
🐛 Bug Fixes
- fix(MongoDb): Probe the server instead of counting log messages before initiating (#1735) @arnelirobles, @HofmeisterAn
- fix(MongoDb): Treat an already initiated replica set as success (#1731) @arnelirobles, @HofmeisterAn
🧹 Housekeeping
- chore: Cleanup and align tests (#1740) @HofmeisterAn
- chore: Set Cake build solution file path to Testcontainers.slnx (#1728) @0xced
- chore: Keep Testcontainers.slnx solution file only (#1725) @0xced
- feat: Prepare next release cycle (4.14.0) (#1726) @HofmeisterAn
📦 Dependency Updates
- chore(deps): Bump SSH.NET to 2026.0.0 and BouncyCastle.Cryptography to 2.7.0 (#1739) @markmario
- chore(deps): Bump the actions group with 10 updates (#1730) @dependabot[bot]
4.13.0
What's Changed
Thank you to everyone who contributed and shared their feedback 🤜🤛.
The NuGet packages for this release have been attested for supply chain security using actions/attest. This confirms the integrity and provenance of the artifacts and helps ensure they can be trusted: #33686956.
🚀 Features
- feat: Add Aspire dashboard module (#1194) @NikiforovAll
- feat: Add image name substitution hook (#1710) @HofmeisterAn
- feat(CosmosDb): Add get method AccountEndpoint (#1707) @srollinet
- feat: Improve image build failure messages (#1700) @HofmeisterAn
🐛 Bug Fixes
- fix: Restore tar archive write performance regressed by padding trim (#1719) @HofmeisterAn
- chore: Bump Docker.DotNet from 4.3.2 to 4.3.3 (#1714) @HofmeisterAn
- chore(AspireDashboard): Cover connection string provider (#1713) @HofmeisterAn
📖 Documentation
- docs: Add missing TC languages and reorder docs navigation (#1711) @mdelapenya
- docs: Add note about unsupported BuildKit Dockerfile features (#1696) @HofmeisterAn
- docs: Explain immutable builder behavior (#1693) @HofmeisterAn
🧹 Housekeeping
- chore: Enable Dependabot cooldown (#1716) @HofmeisterAn
- chore: Add nuget.config (#1715) @Rob-Hague
- chore(AspireDashboard): Cover connection string provider (#1713) @HofmeisterAn
- chore: Bump Docker.DotNet from 4.2.0 to 4.3.2 (#1712) @HofmeisterAn
- chore: Bump sshd-docker image from 1.3.0 to 1.4.0 (#1709) @HofmeisterAn
- chore: Rename runtime label and add buildkit and stale labels (#1703) @HofmeisterAn
- fix: Guard expensive argument evaluation when logging (#1702) @HofmeisterAn
- chore: Defer container ID truncation in logging (#1701) @HofmeisterAn
- chore: Migrate to LoggerMessageAttribute (#1697) @HofmeisterAn
📦 Dependency Updates
- chore(deps): Bump the actions group with 2 updates (#1721) @dependabot[bot]
- chore(deps): Bump the actions group with 7 updates (#1717) @dependabot[bot]
- chore: Bump Docker.DotNet from 4.3.2 to 4.3.3 (#1714) @HofmeisterAn
- chore: Bump Docker.DotNet from 4.2.0 to 4.3.2 (#1712) @HofmeisterAn
- chore(deps): Bump the actions group with 4 updates (#1698) @dependabot[bot]
4.12.0
What's Changed
Thanks to all contributors 👏.
The NuGet packages for this release have been attested for supply chain security using actions/attest. This confirms the integrity and provenance of the artifacts and helps ensure they can be trusted: #28009236.
⚠️ Breaking Changes
- chore(deps): Bump Docker.DotNet from 3.131.1 to 4.0.2 (#1665) @HofmeisterAn
🚀 Features
- feat: Add Floci module (#1690) @object
- feat: Ignore port-forwarding extra host in reuse hash (#1689) @HofmeisterAn
- feat: Allow devs to override the reuse hash calculation (#1688) @HofmeisterAn
- feat: Add connect to network API (#1672) @HofmeisterAn
- feat(LocalStack): Require auth token for 4.15 and onwards (#1667) @HofmeisterAn
- chore(deps): Bump Docker.DotNet from 3.131.1 to 4.0.2 (#1665) @HofmeisterAn
🐛 Bug Fixes
- fix: Trim tar record padding to avoid broken-pipe failure on Podman (#1684) @artiomchi
- fix(Nats): Use healthz API for readiness probe (#1679) @eriblo01
- fix: Remove KeepAlive socket option (#1671) @Angelinsky7
📖 Documentation
- docs: Extend WithCommand(params string[]) documentation (#1685) @HofmeisterAn
🧹 Housekeeping
- feat: Prepare next release cycle (4.12.0) (#1664) @HofmeisterAn
📦 Dependency Updates
- chore(deps): Bump the actions group with 5 updates (#1687) @dependabot[bot]
- chore(deps): Bump Docker.DotNet from 4.1.0 to 4.2.0 (#1686) @HofmeisterAn
- chore(deps): Bump the actions group with 5 updates (#1676) @dependabot[bot]
- chore(deps): Bump Docker.DotNet from 4.0.2 to 4.1.0 (#1674) @HofmeisterAn
- chore(deps): Bump Docker.DotNet from 3.131.1 to 4.0.2 (#1665) @HofmeisterAn
4.11.0
What's Changed
Thanks to all contributors. Once again, really great contributions from everyone 🤝.
The NuGet packages for this release have been attested for supply chain security using actions/attest. This confirms the integrity and provenance of the artifacts and helps ensure they can be trusted: #21198535.
Please be aware that we have changed the supported and underlying image used for the Cosmos DB module. The latest tag only supports certain environments and provides a limited set of features. Microsoft has introduced a new implementation, vnext-preview, which receives more updates and features. Due to the limitations of the latest tag, we decided to replace it with vnext-preview. You find more information about the image here: https://github.com/Azure/azure-cosmos-db-emulator-docker.
⚠️ Breaking Changes
🚀 Features
- feat(CosmosDb): Update base image from latest to vnext-preview (#1324) @NelsonBN
- feat: Add typed WithResourceMapping(...) overloads (#1497) @cimnine
- feat: Add Seq module (#1276) @montanehamilton
- feat(PostgreSql): Add WithSsl builder API (#1529) @ozkanpakdil
- feat: Add Temporal module (#1635) @bgener
- feat: Add module connection string provider (#1632) @HofmeisterAn
- fead: Add default container connection string provider (#1630) @HofmeisterAn
- feat(ServiceBus): Add method to get HTTP connection string (#1622) @NelsonBN
🐛 Bug Fixes
- fix(MongoDb): Wait for post-init startup readiness before replica set initiation (#1656) @HofmeisterAn
- fix(Seq): Assert connection string provider (#1645) @HofmeisterAn
- fix(EventHubs): Ignore runtime property to support reuse (#1644) @franciscosamuel
- fix(ServiceBus): Ignore runtime property to support reuse (#1643) @franciscosamuel
- fix(ResourceReaper): Set wait strategy (#1634) @HofmeisterAn
- fix(ServiceBus): Workaround health API timeout (#1625) @HofmeisterAn
- fix: Do not set console buffer width (ConsoleLogger) (#1623) @HofmeisterAn
- fix(EventHubs): Workaround health API timeout (#1624) @HofmeisterAn
📖 Documentation
- docs(CosmosDb): Replace unsupported tag 'latest' with 'vnext-preview' (#1660) @HofmeisterAn
- docs(Redis): Add example (#1641) @HofmeisterAn
🧹 Housekeeping
- chore(examples): Enable NuGet restore lock mode (#1659) @HofmeisterAn
- chore: Pin image digest (#1658) @HofmeisterAn
- fix: Run OpenSSF Scorecard only on default branch (#1657) @HofmeisterAn
- chore: Remove Git LFS tracking for .snk (#1655) @HofmeisterAn
- feat: Enable Dependabot for NuGet (repo) (#1654) @HofmeisterAn
- feat: Enable Dependabot for NuGet (src) (#1653) @HofmeisterAn
- fix: Replace branch protection with ruleset (#1652) @HofmeisterAn
- fix: Do not enforce policies for admins (#1651) @HofmeisterAn
- fix: Remove missing labels from Dependabot (#1650) @HofmeisterAn
- chore: Set top-level permissions to read-all (#1649) @HofmeisterAn
- chore: Remove Sonar findings (#1646) @HofmeisterAn
- chore: Bump Docker Engine API to 1.52 (#1633) @HofmeisterAn
- chore: Update examples to use TC for .NET 4.10.0 (#1616) @HofmeisterAn
- feat: Prepare next release cycle (4.11.0) (#1615) @HofmeisterAn
📦 Dependency Updates
4.10.0
What's Changed
Happy New Year, everyone! 🎉
Please note that going forward, we expect developers to explicitly pin the image version (https://github.com/testcontainers/testcontainers-dotnet/discussions/1470). We consider this a best practice and it aligns with other language implementations.
Also, due to the recent Docker Engine v29 release, TC for .NET pins the Docker Engine API version to 1.44 (see the previous release notes). You can override this default and set it to the version you're using, ideally 1.52, which corresponds to v29, if you're already running it.
⚠️ Breaking Changes
- feat: Add Docker Engine v29 support (#1609) @HofmeisterAn
- chore: Remove EventStoreDb module (#1599) @HofmeisterAn
🚀 Features
- feat: Require explicit container image in Testcontainers.Xunit (#1612) @0xced
- feat: Add Platform property to IImage interface (#1610) @HofmeisterAn
- feat: Add Docker Engine v29 support (#1609) @HofmeisterAn
- feat: Require explicit container image when creating container builder (#1584) @digital88
- feat: Add connection string provider (#1588) @HofmeisterAn
🐛 Bug Fixes
- fix(Kafka): Bump image version to prevent container crash on startup (#1604) @HofmeisterAn
- fix(Elasticsearch): Use HTTP wait strategy (#1593) @digital88
- fix(Milvus): Use healthcheck wait strategy (#1585) @verdie-g
📖 Documentation
- docs: Pin the image version explicitly (#1605) @HofmeisterAn
🧹 Housekeeping
- chore: Remove Sonar findings (#1611) @HofmeisterAn
- chore: Pin Docker Engine API for GH workflow to 1.47 (#1608) @HofmeisterAn
- chore: Set remaining container image explicit (#1606) @digital88
- fix(Kafka): Bump image version to prevent container crash on startup (#1604) @HofmeisterAn
- chore: Remove EventStoreDb test project from SLNX file (#1603) @0xced
- chore: Skip unnecessary work for empty or null sequences (#1601) @HofmeisterAn
- chore: Delegate container builder ctor string to IImage (#1600) @HofmeisterAn
- chore: Remove EventStoreDb module (#1599) @HofmeisterAn
- feat: Prepare next release cycle (4.10.0) (#1586) @HofmeisterAn
4.9.0
What's Changed
This release adds a new configuration (DOCKER_API_VERSION) that lets you pin and downgrade the Docker Engine API version. This was needed because Docker Engine v29 introduced breaking changes that affect Docker.DotNet and Testcontainers for .NET. This release pins the API version to 1.44. So far, no issues or negative side effects have been observed.
I am also working on updating Docker.DotNet to make it fully compatible with Docker Engine v29. There is already a work-in-progress PR.
Thanks to all the contributors who helped with this release 👍.
⚠️ Breaking Changes
- feat: Add KurrentDb module (#1583) @diegosasw
🚀 Features
- feat: Add KurrentDb module (#1583) @diegosasw
- chore: Bump NuGet dependencies (#1578) @HofmeisterAn
- feat: Add .NET 10 support (#1572) @HofmeisterAn
- feat: Support configuring Docker API version (#1576) @HofmeisterAn
- feat: Add Mosquitto module (#1522) @EtherZa
- feat: Add Toxiproxy module (#1454) @iltertaha
- feat: Add Grafana module (#1509) @thomhurst
- feat: Add Playwright module (#1288) @alimahboubi
🐛 Bug Fixes
- fix(Milvus): Set DEPLOY_MODE=STANDALONE (necessary for v2.6+) (#1569) @verdie-g
- fix: Set Kusto wait strategy encoding to UTF-8 (#1567) @MattKotsenas
- fix: Split ALL_CHANGED_FILES on any whitespace (#1566) @HofmeisterAn
📖 Documentation
- docs: Use correct comment characters for C# language (#1564) @HofmeisterAn
🧹 Housekeeping
- feat: Add SLNX file (#1579) @HofmeisterAn
- chore: Update Toxiproxy NuGet dependency to a .NET compatible version (#1568) @HofmeisterAn
- chore: Add script to detect which tests to run in CI (#1563) @HofmeisterAn
- chore: Make the continuous delivery job fork-friendly (#1559) @0xced
- feat: Prepare next release cycle (4.9.0) (#1561) @HofmeisterAn