Repository navigation
Releases
v0.45.0
What's Changed
⚠️ Breaking Changes
- chore(modules)!: extract CockroachDB and Dex client adapters (#4087) @mdelapenya
Client SDK dependencies have moved into separate examples modules. For CockroachDB,
ConnectionConfigis now available throughcockroachdbexamples.NewContainer(c)inmodules/cockroachdb/examples. The parent’sConnectionStringandMustConnectionStringnow return PostgreSQL URLs instead of registered pgx handles, and importing the parent no longer registers the pgx SQL driver. Use the examples adapter to retain the previous SDK behavior, or configure the driver yourself.For Dex,
AddClient,RemoveClient,AddUser, andRemoveUserhave moved from*dex.Containertodexexamples.NewAdminClient(c)inmodules/dex/examples. Static configuration throughWithClientandWithUseris unchanged.
- chore(modules)!: isolate client examples across ten modules (#4081) @mdelapenya
For Cosmos DB,
ContainerPolicyandNewContainerPolicyhave moved frommodules/azure/cosmosdbtomodules/azure/examples/cosmosdb. Update the adapter import; its constructor still accepts the parent container.Run,Container, andConnectionStringremain unchanged in the parent module.
🔒 Security
- security(deps): upgrade otel log sdk to v0.21.0 (#4047) @mdelapenya
🚀 Features
- feat(sbx): configure sandbox startup with Go options (#4057) @mdelapenya
- feat: add Docker Sandboxes runtime provider (#3987) @mdelapenya
- feat(garage): add single-node S3-compatible storage module (#3950) @kanjih
- feat: register runtime providers and introduce the Podman module (#3946) @mdelapenya
- feat: add the ability to configure the provider type in the properties file or as an env var (#3494) @mkeeler
- feat(kafka): add TLS support (#3917) @RuslanKarabalin
🐛 Bug Fixes
- fix(wait): fail fast when logs are unavailable on a stopped container (#3898) @skartikey
- fix(wait): retry HostPortStrategy external check on connect timeout (#4055) @pujitha24
- fix: handle OCI registry manifests and isolate k3s platform test (#4059) @mdelapenya
- fix: setup ExposeHostPorts forward on container start hook (#3200) @mdelapenya
- fix(wait): support non-pointer strategies in ForAny/ForAll nil checks (#4052) @mdelapenya
- fix(rabbitmq): pass the node config from memory instead of a shared temp file (#3881) @manduinca
- fix: dial the sshd container on the Docker daemon host (#3877) @timofurrer
- fix: validate the configured session ID (#3849) @mdelapenya
📖 Documentation
- docs: show cumulative clones and unique cloners (#4082) @mdelapenya
- chore(metrics): update github clones for 2026-10 (#4079) @github-actions[bot]
- chore: update usage metrics (2026-11) (#4077) @github-actions[bot]
- docs: fix dead links in module docs and comments (#4071) @sarankumar1325
- chore(docs): move Python tooling out of the Go module (#3942) @mikey923
- docs: update Podman guide for the provider module (#4038) @mdelapenya
🧹 Housekeeping
- chore(modules): finish test client isolation and document examples modules (#4089) @mdelapenya
- chore(modules): isolate eight remaining compatible client SDKs (#4086) @mdelapenya
- chore(modules)!: extract CockroachDB and Dex client adapters (#4087) @mdelapenya
- chore(modules): isolate client examples across eleven more modules (#4084) @mdelapenya
- fix(ci): initialize sbx network policy before tests (#4085) @mdelapenya
- chore(modules): isolate client examples across eleven modules (#4083) @mdelapenya
- chore: update modules usage metrics (2026-11) (#4078) @github-actions[bot]
- chore(modules): remove client-only dependencies from nine modules (#4073) @mdelapenya
- chore(modules): isolate client examples for five modules (#4070) @mdelapenya
- chore(redis): isolate client examples in a separate module (#4063) @mdelapenya
- chore: bump Go patch releases after CA certificates incident (#4060) @mdelapenya
- chore(docs): move Python tooling out of the Go module (#3942) @mikey923
- chore(deps): bump github.com/stretchr/testify in /modulegen (#4037) @dependabot[bot]
- chore(deps): bump github.com/stretchr/testify from 1.11.1 to 1.12.1 (#3994) @dependabot[bot]
- chore(deps): bump Go to 1.26 everywhere (#3940) @mdelapenya
- feat(metrics): track daily GitHub clones on the usage-metrics site (#3920) @mdelapenya
- fix(minio): point MinIO image references to Quay, retiring it from CI matrix (#3932) @copilot-swe-agent[bot]
- chore: update usage metrics (2026-10) (#3919) @github-actions[bot]
- chore: update modules usage metrics (2026-09) (#3863) @github-actions[bot]
- chore: update usage metrics (2026-09) (#3862) @github-actions[bot]
- chore(mariadb): update test image to 12.3.2 (#3848) @lucastsudaka
📦 Dependency updates
- chore(deps): bump github.com/go-jose/go-jose/v4 from 4.1.4 to 4.1.6 in /modules/dex/examples (#4088) @dependabot[bot]
- chore(deps): bump go.mongodb.org/mongo-driver from 1.17.6 to 1.17.7 in /modules/weaviate/examples (#4075) @dependabot[bot]
- chore(deps): bump github.com/weaviate/weaviate from 1.29.0 to 1.38.0 in /modules/weaviate/examples (#4076) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.67.0 to 1.83.2 in /modules/pinecone/examples (#4074) @dependabot[bot]
- chore(modules): remove client-only dependencies from nine modules (#4073) @mdelapenya
- chore(modules): isolate client examples for five modules (#4070) @mdelapenya
- chore(redis): isolate client examples in a separate module (#4063) @mdelapenya
- fix(fakegcsserver): update image to avoid socketcall failures (#4062) @mdelapenya
- chore(deps): bump github.com/go-jose/go-jose/v4 from 4.1.4 to 4.1.6 in /modules/gcloud (#4061) @dependabot[bot]
- chore(deps): bump actions/upload-artifact from 7.0.1 to 7.0.2 (#4042) @dependabot[bot]
- chore(deps): bump github.com/aws/aws-sdk-go-v2/service/dynamodb in /modules/dynamodb (#4039) @dependabot[bot]
- chore(deps): bump docker/setup-docker-action from 5.4.0 to 5.5.0 (#3993) @dependabot[bot]
- chore(deps): bump certifi from 2026.2.25 to 2026.10.19 in /docs-site (#4049) @dependabot[bot]
- security(deps): upgrade otel log sdk to v0.21.0 (#4047) @mdelapenya
- chore(deps): bump github.com/magiconair/properties in / (#4046) @dependabot[bot]
- chore(deps): bump github.com/rabbitmq/amqp091-go in /modules/rabbitmq (#4048) @dependabot[bot]
- security(deps): upgrade grpc to v1.83.2 (#4045) @mdelapenya
- chore(deps): bump peter-evans/slash-command-dispatch from 4.0.0 to 5.0.2 (#3952) @dependabot[bot]
- chore(deps): bump ossf/scorecard-action from 2.4.3 to 2.5.0 (#3958) @dependabot[bot]
- chore(deps): bump github.com/moby/go-archive from 0.2.0 to 0.3.3 (#3996) @dependabot[bot]
- chore(deps): bump github.com/stretchr/testify in /modulegen (#4037) @dependabot[bot]
- chore(deps): bump github.com/stretchr/testify from 1.11.1 to 1.12.1 (#3994) @dependabot[bot]
- chore(deps): group Go updates across modules (#4035) @mdelapenya
- chore(deps): bump github.com/moby/sys/user from 0.4.0 to 0.4.1 in /modules/s3mock (#3992) @dependabot[bot]
- chore(deps): bump github.com/moby/sys/user from 0.4.0 to 0.4.1 in /modules/scylladb (#3991) @dependabot[bot]
- chore(deps): bump github.com/moby/sys/user from 0.4.0 to 0.4.1 in /modules/typesense (#3990) @dependabot[bot]
- chore(deps): bump github.com/moby/sys/user from 0.4.0 to 0.4.1 in /modules/socat (#3988) @dependabot[bot]
- chore(deps): bump test-summary/action from 2.4 to 2.6 (#3953) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.54.0 to 0.58.0 (#3954) @dependabot[bot]
- chore(deps): bump github.com/moby/moby/client from 0.6.0 to 0.6.2 (#3955) @dependabot[bot]
- chore(deps): bump github.com/moby/sys/user from 0.4.0 to 0.4.1 in /modules/yugabytedb (#3986) @dependabot[bot]
- chore(deps): bump Go to 1.26 everywhere (#3940) @mdelapenya
- chore(deps): bump github.com/moby/moby/client from 0.5.0 to 0.6.0 (#3938) @mdelapenya
- chore(deps): bump urllib3 from 2.7.0 to 2.8.0 (#3935) @dependabot[bot]
- chore(deps): bump github/codeql-action/init and github/codeql-action/analyze from 3.30.3 to 4.38.2 (#3939) @mdelapenya
- chore(deps): bump github.com/containerd/containerd/v2 from 2.2.8 to 2.2.9 in /modules/compose (#3914) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.83.0 to 1.83.2 in /modules/milvus (#3911) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc from 1.44.0 to 1.45.0 in /modules/compose (#3904) @dependabot[bot]
- chore(deps)...
v0.44.0
What's Changed
🔒 Security
- security: fix Dependabot alerts for grpc and OTel (#3835) @mdelapenya
🚀 Features
- feat: allow overriding the session ID (#3051) @jcmfernandes
- feat: add Azure SQL Edge module (#3787) @mdelapenya
- feat: add S3Mock module (#3781) @mdelapenya
- feat: add Fake-GCS-Server module (#3770) @mdelapenya
- feat: add Typesense module (#3786) @mdelapenya
- feat: add Firebird module (#3771) @mdelapenya
- feat: add CouchDB module (#3768) @mdelapenya
- feat: add Mosquitto module (#3774) @mdelapenya
- feat: add Papercut-SMTP module (#3777) @mdelapenya
- feat: add Timeplus module (#3784) @mdelapenya
- feat: add Solr module (#3783) @mdelapenya
- feat: add SFTP module (#3782) @mdelapenya
- feat: add RavenDB module (#3780) @mdelapenya
- feat: add QuestDB module (#3779) @mdelapenya
- feat: add Presto module (#3778) @mdelapenya
- feat: add OrientDB module (#3776) @mdelapenya
- feat: add Nginx module (#3775) @mdelapenya
- feat: add Mailpit module (#3773) @mdelapenya
- feat: add Trino module (#3785) @mdelapenya
- feat: add KurrentDB module (#3772) @mdelapenya
- feat: add CrateDB module (#3769) @mdelapenya
- feat: add ActiveMQ Classic module (#3767) @mdelapenya
- feat: add ability to chain WithConfigModifier, WithEndpointSettingsModifier and WithHostConfigModifier (#3733) @LaurentGoderre
🐛 Bug Fixes
- fix: escape the container name in the Docker name filter (#3837) @jcmfernandes
- fix: should print max information by default (#3459) @strowk
- fix: read exec exit code only after draining the output stream (#3766) @dean-island
- fix: properly wait for Ryuk startup when reusing reaper (#3761) @karsov
- fix(openfga): remove playground wait from Run and up image to v1.18.0 (#3745) @selvakannanjr
📖 Documentation
- docs: fix incomplete CleanupContainer documentation (#3826) @Hashim1999164
- docs: fix typo in SkipIfProviderIsNotHealthy docstring (#3764) @salandered
- chore: update modules usage metrics (2026-07) (#3759) @github-actions[bot]
- chore: update usage metrics (2026-07) (#3757) @github-actions[bot]
- chore(metrics): usage metrics for modules (#3737) @mdelapenya
- docs(site): add missing languages and reorder docs navigation (#3735) @mdelapenya
🧹 Housekeeping
- chore: update usage metrics (2026-08) (#3830) @github-actions[bot]
- chore: update modules usage metrics (2026-08) (#3831) @github-actions[bot]
- fix: correct indentation in dependabot.yml (#3808) @mdelapenya
- chore(compose): use require instead of assert for service name checks (#3765) @sunghyun1999
- chore: update usage metrics (2026-07) (#3757) @github-actions[bot]
- chore(wait): replace manual StrategyTarget mocks with generated mockery mocks (#3603) @mateenali66
- chore: use testify's require instead of assert (#3740) @TheRodzz
- fix(metrics): harden collect.go and modules workflow (#3738) @mdelapenya
📦 Dependency updates
- chore(deps): bump slackapi/slack-github-action from 3.0.3 to 4.0.0 (#3788) @dependabot[bot]
- chore(deps): bump actions/upload-artifact from 7.0.0 to 7.0.1 (#3789) @dependabot[bot]
- chore(deps): bump docker/setup-docker-action from 5.1.0 to 5.4.0 (#3790) @dependabot[bot]
- chore(azurite): tidy module dependencies (#3838) @mdelapenya
- security: fix Dependabot alerts for grpc and OTel (#3835) @mdelapenya
- chore(deps): bump github.com/Azure/azure-sdk-for-go/sdk/storage/azblob from 1.6.0 to 1.8.0 in /modules/azure (#3805) @dependabot[bot]
- chore(deps): bump github.com/Azure/azure-sdk-for-go/sdk/security/keyvault/azsecrets from 1.4.0 to 1.5.0 in /modules/azure (#3806) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.79.3 to 1.82.1 in /modules/weaviate (#3820) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.79.3 to 1.82.1 in /modules/qdrant (#3821) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.80.0 to 1.82.1 in /modules/grafana-lgtm (#3822) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.81.0 to 1.82.1 in /modules/gcloud (#3823) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.81.1 to 1.82.1 in /modules/compose (#3824) @dependabot[bot]
- chore: propagate azcore dependency update to azurite module (#3818) @mdelapenya
- chore(deps): bump github.com/Azure/azure-sdk-for-go/sdk/azcore from 1.21.1 to 1.22.0 in /modules/azure (#3809) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.53.0 to 0.54.0 (#3791) @dependabot[bot]
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.26.5 to 4.26.6 (#3750) @dependabot[bot]
- chore(deps): bump github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos from 1.4.1 to 1.5.0 in /modules/azure (#3810) @dependabot[bot]
- chore(deps): bump github.com/aws/aws-sdk-go-v2/credentials from 1.17.5 to 1.19.29 in /modules/localstack (#3812) @dependabot[bot]
- chore(deps): bump github.com/aws/aws-sdk-go-v2/credentials from 1.19.28 to 1.19.29 in /modules/s3mock (#3813) @dependabot[bot]
- chore(deps): bump github.com/aws/aws-sdk-go-v2/credentials from 1.17.46 to 1.19.29 in /modules/scylladb (#3814) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.53.0 to 0.54.0 in /modules/azure (#3811) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.53.0 to 0.54.0 in /modules/azure (#3794) @dependabot[bot]
- chore(deps): bump github.com/go-stomp/stomp/v3 from 3.0.5 to 3.1.5 in /modules/artemis (#3801) @dependabot[bot]
- chore(deps): bump github.com/Azure/azure-sdk-for-go/sdk/azidentity from 1.13.1 to 1.14.0 in /modules/azure (#3803) @dependabot[bot]
- chore(deps): bump software.sslmate.com/src/go-pkcs12 from 0.6.0 to 0.7.3 in /modules/cassandra (#3804) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.37.0 to 0.38.0 in /modules/elasticsearch (#3796) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.37.0 to 0.38.0 in /modules/kafka (#3797) @dependabot[bot]
- chore(deps): bump github.com/arangodb/go-driver/v2 from 2.1.3 to 2.3.1 in /modules/arangodb (#3800) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.52.0 to 0.54.0 in /modules/dex (#3795) @dependabot[bot]
- chore(deps): bump github.com/aerospike/aerospike-client-go/v8 from 8.6.0 to 8.7.0 in /modules/aerospike (#3799) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.51.0 to 0.52.0 in /modules/dex (#3763) @dependabot[bot]
- chore(deps): bump golang.org/x/net from 0.53.0 to 0.55.0 in /modules/dex (#3758) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.36.0 to 0.37.0 in /modulegen (#3751) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.33.0 to 0.37.0 in /modules/redpanda (#3756) @dependabot[bot]
- chore(deps): bump golangci/golangci-lint-action from 7.0.0 to 9.3.0 (#3748) @dependabot[bot]
- chore(deps): bump tj-actions/changed-files from 47.0.1 to 47.0.6 (#3746) @dependabot[bot]
- chore(deps): bump SonarSource/sonarqube-scan-action from 5.1.0 to 8.2.0 (#3747) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.2.2 to 7.3.0 (#3749) @dependabot[bot]
- chore(deps): bump golang.org/x/text from 0.34.0 to 0.38.0 in /modulegen (#3752) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.33.0 to 0.37.0 in /modules/elasticsearch (#3753) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.33.0 to 0.37.0 in /modules/kafka (#3754) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.33.0 to 0.37.0 in /modules/localstack (#3755) @dependabot[bot]
- chore(deps): bump actions/github-script from 7.0.1 to 9.0.0 (#3675) @dependabot[bot]
- chore(deps): bump pymdown-extensions from 10.16.1 to 10.21.3 (#3707) @dependabot[bot]
- chore(deps): bump go.mongodb.org/mongo-driver/v2 from 2.3.0 to 2.4.2 in /modules/mongodb (#3730) @dependabot[bot]
- chore(deps): bump go.mongodb.org/mongo-driver from 1.14.0 to 1.17.7 in /modules/weaviate (#3731) @dependabot[bot]
- chore(deps): update moby to latest version (#3736) @Steven-Harris
v0.43.0
What's Changed
⚠️ Breaking Changes
- chore(wait)!: change url callback in wait.ForSQL to accept network.Port (#3650) @thaJeztah
Users of
wait.ForSQLneed to follow the new API contract, using Moby'snetwork.Portinstead ofstringwhen building the callback function to check the URL. Please see https://golang.testcontainers.org/features/wait/sql/
- feat!: add PullImageWithPlatform to DockerProvider (#3710) @blueprismo
Users implementing their own
testcontainers.ImageProviderneed to implement the newPullImageWithPlatformmethod introduced by this PR.
🚀 Features
- feat(k3s): pull image opts (#3716) @blueprismo
- feat(wait): implement AnyMultiStrategy: ForAny equivalent to ForAll. (#3719) @jeanbza
- feat(eventhubs): add WithAzuriteContainer and functional-options config builder (#3722) @mdelapenya
- feat!: add PullImageWithPlatform to DockerProvider (#3710) @blueprismo
- feat(modules/dex): add Dex OIDC provider module (#3659) @guilycst
🐛 Bug Fixes
- fix(security): remove debug code that leaks Docker credentials (#3721) @mdelapenya
- fix(ollama): align local exec test with Ollama 0.30.6 log format (#3715) @mdelapenya
- fix: close temp file handle before removal (#3672) @acouvreur
- fix(compose): close docker clients to prevent goroutine leaks (#3661) @mdelapenya
- fix: wait for log production goroutine to drain on stop (#3660) @mdelapenya
📖 Documentation
- chore: update usage metrics (2026-06) (#3714) @github-actions[bot]
🧹 Housekeeping
- chore(wait)!: change url callback in wait.ForSQL to accept network.Port (#3650) @thaJeztah
- chore: update usage metrics (2026-05) (#3670) @github-actions[bot]
- chore: remove cgroupnsMode setting from K3s container configuration (#3653) @lixin9311
📦 Dependency updates
- chore(deps): update dependencies to latest versions in go.mod and go.sum (#3729) @Steven-Harris
- chore: bump sshd-docker image to 1.4.0 (#3727) @mdelapenya
- chore(deps): bump Ryuk to v0.14.0 (#3313) @mdelapenya
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.26.4 to 4.26.5 (#3713) @dependabot[bot]
- chore(deps): bump golang.org/x/sys from 0.44.0 to 0.45.0 (#3712) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.2.2 to 7.3.0 (#3711) @dependabot[bot]
- chore(deps): bump slackapi/slack-github-action from 2.1.1 to 3.0.3 (#3677) @dependabot[bot]
- chore(deps): bump idna from 3.11 to 3.15 (#3708) @dependabot[bot]
- chore(deps): bump github.com/containerd/containerd/v2 from 2.2.2 to 2.2.4 in /modules/compose (#3709) @dependabot[bot]
- chore(deps): bump urllib3 from 2.6.3 to 2.7.0 (#3704) @dependabot[bot]
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.26.3 to 4.26.4 (#3667) @dependabot[bot]
- chore(deps): bump github.com/moby/moby/api from 1.54.1 to 1.54.2 (#3676) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.48.0 to 0.51.0 (#3689) @mdelapenya
- chore(deps): bump google.golang.org/grpc from 1.79.3 to 1.81.0 in /modules/gcloud (#3690) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.75.0 to 1.81.0 in /modules/dex (#3686) @dependabot[bot]
- chore(deps): bump github.com/in-toto/in-toto-golang from 0.10.0 to 0.11.0 in /modules/compose (#3674) @dependabot[bot]
- chore(deps): bump docker/setup-docker-action from 4.5.0 to 5.1.0 (#3664) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.2.1 to 7.2.2 (#3665) @dependabot[bot]
- chore(deps): bump github.com/apache/thrift from 0.21.0 to 0.23.0 in /modules/nebulagraph (#3673) @dependabot[bot]
- chore(deps): bump github.com/Azure/go-ntlmssp from 0.0.0-20221128193559-754e69321358 to 0.1.1 in /modules/openldap (#3658) @dependabot[bot]
- chore(deps): bump github.com/jackc/pgx/v5 from 5.9.0 to 5.9.2 in /modules/postgres (#3657) @dependabot[bot]
- chore(deps): bump github.com/jackc/pgx/v5 from 5.5.4 to 5.9.2 in /modules/cockroachdb (#3656) @dependabot[bot]
- chore(deps): bump github.com/jackc/pgx/v5 from 5.5.4 to 5.9.0 in /modules/postgres (#3652) @dependabot[bot]
v0.42.0
What's Changed
⚠️ Breaking Changes
- chore!: migrate to moby modules (#3591) @thaJeztah
🔒 Security
- chore(deps): bump moby/client v0.4.0, moby/api v1.54.1 (#3634) @thaJeztah
🐛 Bug Fixes
🧹 Housekeeping
- chore: gitignore Gas Town agent artifacts (#3633) @mdelapenya
- fix(usage-metrics): include last release in the legend pop over (#3630) @mdelapenya
- chore: update usage metrics (2026-04) (#3621) @github-actions[bot]
- fix(usage-metrics): order of actions matters (#3623) @mdelapenya
- fix(usage-metrics): reduce rate-limit cascade errors (#3622) @mdelapenya
- fix(usage-metrics): replace the per-version inline retry with a multi-pass approach (#3620) @mdelapenya
📦 Dependency updates
- chore(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp from 1.28.0 to 1.43.0 in /modules/grafana-lgtm (#3639) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp from 1.42.0 to 1.43.0 in /modules/compose (#3641) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.42.0 to 1.43.0 in /modules/compose (#3645) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.2.1 to 7.2.2 (#3626) @dependabot[bot]
- chore(deps): bump github.com/aws/aws-sdk-go-v2/service/s3 from 1.51.2 to 1.97.3 in /modules/localstack (#3638) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.41.0 to 1.43.0 in /modules/grafana-lgtm (#3643) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/sdk from 1.41.0 to 1.43.0 in /modules/milvus (#3644) @dependabot[bot]
- chore: update to Go 1.25.9, 1.26.9 (#3647) @thaJeztah
- chore(deps): bump bump github.com/klauspost/compress v1.18.5, github.com/docker/compose v5.1.2 (#3646) @thaJeztah
- chore(deps): bump moby/client v0.4.0, moby/api v1.54.1 (#3634) @thaJeztah
- chore(deps): bump golang.org/x/sys from 0.41.0 to 0.42.0 (#3629) @dependabot[bot]
- chore(deps): bump github.com/moby/patternmatcher from 0.6.0 to 0.6.1 (#3628) @dependabot[bot]
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.26.2 to 4.26.3 (#3627) @dependabot[bot]
- fix(localstack): accept community-archive as a valid tag (#3601) @johnduhart
- chore(deps): bump github.com/go-jose/go-jose/v4 from 4.1.3 to 4.1.4 in /modules/gcloud (#3632) @dependabot[bot]
- chore(deps): bump actions/upload-artifact from 6.0.0 to 7.0.0 (#3625) @dependabot[bot]
- chore(deps): bump pygments from 2.19.2 to 2.20.0 (#3615) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.67.0 to 1.79.3 in /modules/milvus (#3612) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.67.0 to 1.79.3 in /modules/etcd (#3611) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.79.1 to 1.79.3 in /modules/ollama (#3610) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.67.0 to 1.79.3 in /modules/pinecone (#3609) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.67.0 to 1.79.3 in /modules/couchbase (#3608) @dependabot[bot]
- chore(deps): bump requests from 2.32.4 to 2.33.0 (#3604) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.79.1 to 1.79.3 in /modules/meilisearch (#3607) @dependabot[bot]
- chore(deps): bump github.com/moby/buildkit from 0.27.1 to 0.28.1 in /modules/compose (#3605) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.67.0 to 1.79.3 in /modules/qdrant (#3606) @dependabot[bot]
- chore(deps): bump github.com/modelcontextprotocol/go-sdk from 1.3.1 to 1.4.1 in /modules/dockermcpgateway (#3599) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.69.2 to 1.79.3 in /modules/dockermodelrunner (#3594) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.71.0 to 1.79.3 in /modules/toxiproxy (#3595) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.72.0 to 1.79.3 in /modules/weaviate (#3596) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.79.1 to 1.79.3 in /modules/compose (#3597) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.79.1 to 1.79.3 in /modules/grafana-lgtm (#3598) @dependabot[bot]
- chore(deps): bump google.golang.org/grpc from 1.67.0 to 1.79.3 in /modules/gcloud (#3593) @dependabot[bot]
v0.41.0
What's Changed
🚀 Features
- feat: add TiDB module (#3575) @iyiola-dev
- feat: add Forgejo module (#3556) @s04
- feat: improve container conflict detection (#3574) @Desuuuu
- feat(azure): add lowkey vault container (#3542) @nagyesta
- feat(chroma): update to chroma 1.x (#3552) @tazarov
- feat(cassandra): add ssl option cassandra (#3151) @MitulShah1
🐛 Bug Fixes
- fix(redpanda): closing provider in test after use (#3539) @mabrarov
- fix: docker auth for docker.io images (#3482) @LaurentGoderre
- fix(solace): set ulimits for container (#3497) @mdelapenya
- fix(kafka): strip architecture suffix from Kafka image tags for semver parsing (#3276) @asahasrabuddhe
📖 Documentation
- docs(metrics): automate usage metrics collection and publish it in the docs site (#3495) @mdelapenya
🧹 Housekeeping
- chore(deps): bump actions/checkout from 6.0.1 to 6.0.2 (#3560) @dependabot[bot]
- chore(pulsar): bump base image to 4.x, replacing the wait for log strategy with wait for listening port (deterministic) (#3573) @mdelapenya
- chore(deps): bump github.com/modelcontextprotocol/go-sdk from 1.0.0 to 1.3.1 in /modules/dockermcpgateway (#3557) @dependabot[bot]
- chore: update usage metrics (2026-03-02) (#3565) @github-actions[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.2.0 to 7.2.1 (#3547) @dependabot[bot]
- chore(deps): bump tj-actions/changed-files from 47.0.0 to 47.0.1 (#3546) @dependabot[bot]
- chore(deps): bump actions/upload-artifact from 4.6.2 to 6.0.0 (#3545) @dependabot[bot]
- chore: update usage metrics (2026-02-02) (#3551) @github-actions[bot]
- chore(deps): bump pymdown-extensions from 10.8.1 to 10.16.1 (#3513) @dependabot[bot]
- chore: update usage metrics (2026-01-01) (#3515) @github-actions[bot]
- chore: update usage metrics (2025-12-01) (#3506) @github-actions[bot]
- chore(metrics): allow sending PRs from the workflow (#3503) @mdelapenya
- fix(metrics): use the right CSV file (#3502) @mdelapenya
- fix(metrics): use the right CSV file (#3501) @mdelapenya
- chore(metrics): even better rate limit strategy (#3500) @mdelapenya
- chore(metrics): properly detect rate limits (#3499) @mdelapenya
- fix(metrics): set GH _TOKEN in workflow (#3498) @mdelapenya
📦 Dependency updates
- fix: update compose-replace Makefile target to use compose/v5 (#3590) @mdelapenya
- chore(deps): bump atomicjar/testcontainers-cloud-setup-action from 1.3.0 to 1.4.0 (#3559) @dependabot[bot]
- chore(deps): bump golang.org/x/text from 0.14.0 to 0.34.0 in /modulegen (#3582) @dependabot[bot]
- chore(deps): bump mkdocs-codeinclude-plugin from 0.2.1 to 0.3.1 (#3579) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.16.0 to 0.33.0 in /modulegen (#3583) @dependabot[bot]
- chore(deps): bump github.com/aerospike/aerospike-client-go/v8 from 8.2.0 to 8.6.0 in /modules/aerospike (#3584) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.16.0 to 0.33.0 in /modules/localstack (#3587) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.16.0 to 0.33.0 in /modules/elasticsearch (#3585) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.16.0 to 0.33.0 in /modules/redpanda (#3588) @dependabot[bot]
- chore(deps): bump golang.org/x/mod from 0.16.0 to 0.33.0 in /modules/kafka (#3586) @dependabot[bot]
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.25.12 to 4.26.2 (#3576) @dependabot[bot]
- chore(deps): bump github.com/moby/go-archive from 0.1.0 to 0.2.0 (#3548) @dependabot[bot]
- chore(deps): bump github.com/moby/term from 0.5.0 to 0.5.2 (#3081) @dependabot[bot]
- chore(deps): bump actions/checkout from 6.0.1 to 6.0.2 (#3560) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/sdk to v1.41.0 (#3589) @mdelapenya
- chore(deps): bump go to 1.25 everywhere (#3572) @mdelapenya
- chore(deps): bump github.com/sigstore/sigstore from 1.10.0 to 1.10.4 in /modules/compose (#3571) @dependabot[bot]
- chore(compose): update to compose-v5 (#3568) @mdelapenya
- chore(deps): bump github.com/modelcontextprotocol/go-sdk from 1.0.0 to 1.3.1 in /modules/dockermcpgateway (#3557) @dependabot[bot]
- chore(deps): bump mkdocs-codeinclude-plugin from 0.2.1 to 0.3.1 (#3561) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.2.0 to 7.2.1 (#3562) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/sdk from 1.28.0 to 1.40.0 in /modules/grafana-lgtm (#3563) @dependabot[bot]
- chore(deps): bump go.opentelemetry.io/otel/sdk from 1.35.0 to 1.40.0 in /modules/toxiproxy (#3564) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.2.0 to 7.2.1 (#3547) @dependabot[bot]
- chore(deps): bump tj-actions/changed-files from 47.0.0 to 47.0.1 (#3546) @dependabot[bot]
- chore(deps): bump actions/upload-artifact from 4.6.2 to 6.0.0 (#3545) @dependabot[bot]
- chore(deps): bump urllib3 from 2.6.0 to 2.6.3 (#3538) @dependabot[bot]
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.25.6 to 4.25.12 (#3519) @dependabot[bot]
- chore(deps): bump golang.org/x/sys from 0.38.0 to 0.39.0 (#3521) @dependabot[bot]
- chore(deps): bump ossf/scorecard-action from 2.4.1 to 2.4.3 (#3516) @dependabot[bot]
- chore(deps): bump github.com/docker/docker from 28.5.1+incompatible to 28.5.2+incompatible (#3537) @mdelapenya
- chore(deps): bump pymdown-extensions from 10.8.1 to 10.16.1 (#3513) @dependabot[bot]
- chore(deps): bump actions/checkout from 4.2.2 to 6.0.1 (#3517) @dependabot[bot]
- chore(deps): bump github.com/weaviate/weaviate from 1.29.0 to 1.30.20 in /modules/weaviate (#3511) @dependabot[bot]
- chore(deps): bump urllib3 from 2.5.0 to 2.6.0 (#3508) @dependabot[bot]
- chore: switch YAML library (#3507) @ash2k
- chore(deps): bump golang.org/x/crypto from 0.43.0 to 0.45.0 (#3493) @dependabot[bot]
- chore(deps): bump github.com/dvsekhvalnov/jose2go from 1.6.0 to 1.7.0 in /modules/pulsar (#3491) @dependabot[bot]
- chore(deps): bump github.com/containerd/containerd/v2 from 2.1.4 to 2.1.5 in /modules/compose (#3487) @dependabot[bot]
v0.40.0
What's Changed
⚠️ Breaking Changes
- chore(redpanda)!: use Run function (#3430) @mdelapenya
- chore(rabbitmq)!: use Run function (#3428) @mdelapenya
- chore(opensearch)!: use Run function (#3423) @mdelapenya
- chore(elasticsearch)!: use Run function (#3407) @mdelapenya
- chore(etcd)!: use Run function (#3409) @mdelapenya
The below modules receive a breaking change in the signature of their functional options, as now all of them return an error when needed (returning nil for success). Therefore, you're only affected when assigning the options to variables.
- Old: type Option func(*options)
- New: type Option func(*options) error
🚀 Features
- feat(azure): add cosmosdb module (#3452) @natsoman
- feat(azure): reduce time/memory by running specific sub-services (#3451) @NathanBaulch
🐛 Bug Fixes
- fix(udp): expose UDP ports properly (#3485) @blueprismo
- fix(compose): update to docker compose v2.40.2 and use api.Compose interface (#3456) @mdelapenya
- fix(surrealdb): use true as value for WithAllowAllCaps option (#3436) @mdelapenya
- fix: use path.Join instead of url.JoinPath when prepending a custom registry to an image (#3308) @fedorkanin
📖 Documentation
- docs: add AI coding agent guidelines (#3446) @mdelapenya
- docs(mssql): describe MSSQL issue with negative certificates (#3417) @mdelapenya
🧹 Housekeeping
- feat(wait): add human-readable String() methods to all wait strategies (#3461) @mdelapenya
- chore: enable prealloc linter and address issues (#3458) @NathanBaulch
- chore(dockermcpgateway): skip testable example as it's not deterministic (#3457) @mdelapenya
- fix(azurite): fix lint (#3453) @mdelapenya
- chore: fix "Redpanda" copy-paste comment everywhere (#3450) @NathanBaulch
- chore: remove redundant wait.ForAll everywhere (#3449) @NathanBaulch
- chore(couchbase|etcd|firestore|mcpgateway|eventhubs|servicebus): apply consistent pattern for options (#3447) @mdelapenya
- chore(modulegen): use Run function when generating modules (#3445) @mdelapenya
- chore(vault): use Run function (#3443) @mdelapenya
- chore(valkey): use Run function (#3440) @mdelapenya
- chore(yugabytedb): use Run function (#3444) @mdelapenya
- chore(weaviate): use Run function (#3442) @mdelapenya
- chore(vearch): use Run function (#3441) @mdelapenya
- chore(toxiproxy): use Run function (#3435) @mdelapenya
- chore(clickhouse|k6|localstack|redpanda|registry|socat): use Run in tests (#3432) @mdelapenya
- chore(surrealdb): use Run function (#3434) @mdelapenya
- chore(scylladb): use Run function (#3433) @mdelapenya
- chore(registry): use Run function (#3431) @mdelapenya
- chore(redis): use Run function (#3429) @mdelapenya
- chore(qdrant): use Run function (#3427) @mdelapenya
- chore(pulsar): use Run function (#3426) @mdelapenya
- chore(postgres): use Run function (#3425) @mdelapenya
- chore(pinecone): use Run function (#3424) @mdelapenya
- chore(openldap): use Run function (#3422) @mdelapenya
- chore(openfga): use Run function (#3421) @mdelapenya
- chore(ollama): use Run function (#3420) @mdelapenya
- chore(neo4j): use Run function (#3419) @mdelapenya
- chore(nats): use Run function (#3418) @mdelapenya
- chore(mysql): use Run function (#3416) @mdelapenya
- chore(meilisearch|memcached|milvus|minio|mockserver|mssql): use Run function (#3415) @mdelapenya
- chore(k6|localstack|kafka|mariadb): use Run function (#3414) @mdelapenya
- chore(inbucket|influxdb|mongodb|k3s): use Run function (#3413) @mdelapenya
- chore(grafana): use Run function (#3412) @mdelapenya
- chore(gcloud): use Run function (#3411) @mdelapenya
- chore(milvus): update Milvus SDK to new module (#3408) @Juneezee
- chore(dynamodb): use Run function (#3406) @mdelapenya
- chore(dolt): use Run function (#3405) @mdelapenya
- chore(dind): use Run function (#3403) @mdelapenya
- chore(docker): fix error messages (#3404) @mdelapenya
- chore(couchbase): use Run function (#3401) @mdelapenya
- chore(databend): use Run function (#3402) @mdelapenya
- fix(openldap): use bitnamilegacy images (#3400) @mdelapenya
- chore(consul): use Run function (#3327) @mdelapenya
- chore(cockroachDB): use Run function (#3326) @mdelapenya
- chore(clickhouse): use Run function (#3325) @mdelapenya
- chore(chroma): use Run function (#3324) @mdelapenya
- chore(cassandra): use Run function (#3321) @mdelapenya
- chore(azurite): use Run function (#3318) @mdelapenya
- chore(artemis): use Run function (#3320) @mdelapenya
- chore(arangodb): use Run function (#3319) @mdelapenya
- chore: update relative-path-mode to "gitroot" in golangci configuration (#3317) @mmorel-35
- chore: enable govet linter (#3315) @mmorel-35
- chore(socat): use Run function (#3312) @mdelapenya
- chore(aerospike): use Run function (#3311) @mdelapenya
- chore: use Run in more tests (part 4) (#3309) @mdelapenya
- chore: use Run function (part 3) (#3307) @mdelapenya
- chore: use Run function (part 2) (#3305) @mdelapenya
- chore: use the Run funcion in tests and docs (part 1) (#3304) @mdelapenya
📦 Dependency updates
- chore(deps): bump amannn/action-semantic-pull-request from 5.5.3 to 6.1.1 (#3328) @dependabot[bot]
- chore(deps): bump golang.org/x/sys from 0.36.0 to 0.37.0 and golang.org/x/crypto from 0.42.0 to 0.43.0 (#3465) @dependabot[bot]
- chore(deps): bump github.com/docker/docker from 28.3.3+incompatible to 28.5.1+incompatible (#3464) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.6 to 7.2.0 (#3463) @dependabot[bot]
- chore(deps): bump actions/setup-go from 5.4.0 to 6.0.0 (#3462) @dependabot[bot]
- fix(compose): update to docker compose v2.40.2 and use api.Compose interface (#3456) @mdelapenya
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.6 to 7.1.8 (#3455) @dependabot[bot]
- chore(deps): bump slackapi/slack-github-action from 2.0.0 to 2.1.1 (#3329) @dependabot[bot]
- chore(deps): bump github.com/cenkalti/backoff/v4 from 4.2.1 to 4.3.0 (#3333) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.37.0 to 0.42.0 (#3332) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.6 to 7.2.0 (#3330) @dependabot[bot]
- chore(deps): bump github.com/stretchr/testify from 1.10 to 1.11.1 (#3399) @mdelapenya
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.6 to 7.1.8 (#3322) @dependabot[bot]
v0.39.0
What's Changed
🚀 Features
- feat(atlaslocal): add MongoDB Atlas Local module (#3254) @prestonvasquez
- feat: allow saving specific platforms for an image (#3218) @LaurentGoderre
- feat(redpanda): add support for http proxy (#3258) @simon0191
- feat(nebulagraph): add NebulaGraph module (#3266) @egasimov
- feat(registry): add helper functions to pull and tag images (#3275) @mdelapenya
- feat: add Solace pubsub+ module (#3230) @unicod3
- feat(options): add WithProvider (#3241) @dfioravanti
- feat(mcpgateay): add Docker's MCP gateway module (#3232) @mdelapenya
🐛 Bug Fixes
- fix: preserve unix socket schema in testcontainersHostFromProperties (#3213) @knqyf263
- fix(reaper): remove termSignal override (#3261) @buraindo
- fix(registry): update
WithHtpasswdto useos.CreateTempinstead ofos.Createwithfilepath.Join. (#3272) @jakobmoellerdev - fix(nats): use wait for listening port instead of wait for log (#3256) @own2pwn
- fix(postgres): snapshot restore (#3264) @ascheman
📖 Documentation
🧹 Housekeeping
- chore(atlas): simplify host-port calculation in tests (#3300) @mdelapenya
- chore(deps): bump tj-actions/changed-files from 46.0.3 to 47.0.0 (#3283) @dependabot[bot]
- chore(modulegen): detect missing project files after new module creation (#3281) @mdelapenya
- chore(release): refine release script to update inter-module dependencies (#3273) @mdelapenya
- chore(postgres): use require.NotNil instead of assert.NotNil (#3252) @nolandseigler
- fix(dockermcpgateway): use duckduckgo instead of brave (#3247) @mdelapenya
📦 Dependency updates
- chore(deps): bump golang.org/x/net from 0.28.0 to 0.38.0 (#3299) @dependabot[bot]
- chore(deps): bump dario.cat/mergo from 1.0.1 to 1.0.2 (#3238) @dependabot[bot]
- chore(deps): bump golang.org/x/sys from 0.32.0 to 0.36.0 (#3282) @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.29.3 to 3.30.3 (#3287) @dependabot[bot]
- chore(go): bump to Go 1.24 as minimal version (#3298) @mdelapenya
- deps(mongodb): update MongoDB Go Driver to v2 (#3278) @matthewdale
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.25.5 to 4.25.6 (#3224) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.6 to 7.1.7 (#3284) @dependabot[bot]
- chore(deps): bump github.com/docker/go-connections from 0.5.0 to 0.6.0 (#3285) @dependabot[bot]
- chore(deps): bump tj-actions/changed-files from 46.0.3 to 47.0.0 (#3283) @dependabot[bot]
- chore(deps): bump github.com/docker/docker from 28.2.2+incompatible to 28.3.3+incompatible in /modules/nebulagraph (#3277) @dependabot[bot]
- chore(deps): bump ryuk to v0.13.0, which uses scratch as base image (#3274) @mdelapenya
- chore(deps): bump github.com/docker/docker from 28.2.2+incompatible to 28.3.3+incompatible (#3270) @mdelapenya
- chore(deps): bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0 in /modules/compose (#3267) @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.29.2 to 3.29.3 (#3237) @dependabot[bot]
- chore(deps): bump golang.org/x/oauth2 from 0.25.0 to 0.27.0 in /modules/weaviate (#3240) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.5 to 7.1.6 (#3239) @dependabot[bot]
- chore(deps): bump requests from 2.32.0 to 2.32.4 (#3204) @dependabot[bot]
- chore(deps): bump golang.org/x/oauth2 from 0.22.0 to 0.27.0 in /modules/pulsar (#3236) @dependabot[bot]
- chore(deps): bump golang.org/x/oauth2 from 0.22.0 to 0.27.0 in /modules/gcloud (#3235) @dependabot[bot]
- chore(deps): bump golang.org/x/oauth2 from 0.18.0 to 0.27.0 in /modules/k3s (#3234) @dependabot[bot]
v0.38.0
What's Changed
⚠️ Breaking Changes
- chore!: do not wait for all the exposed ports to be ready (#3199) @mdelapenya
The breaking change comes as a behaviour that has been removed: the readiness check for the exposed ports. It led to flakiness and for that reason we removed it.
- feat!: add options when creating RawCommand (#3168) @benja-M-1
Only for users of the
testcontainers.NewRawCommandfunction to create executables in containers, that are assigning the function to a variable. We added a variadic argument to the signature, so the rest of the users won't be affected by this breaking change.
- chore(deps)!: bump github.com/docker/docker from 28.1.1+incompatible to 28.2.2+incompatible (#3194) @mdelapenya
Implementers of the
testcontainers.ImageBuildInfointerface, would see thattestcontainers.BuildOptionshas changed its signature to use non-deprecated types fromdocker/docker:
type ImageBuildInfo interface {
- BuildOptions() (types.ImageBuildOptions, error) // converts the ImageBuildInfo to a types.ImageBuildOptions
+ BuildOptions() (build.ImageBuildOptions, error) // converts the ImageBuildInfo to a build.ImageBuildOptionsAlso users of the
testcontainers.FromDockerfilestruct will receive this breaking change, as theBuildOptionsModifierfields has changed:
- BuildOptionsModifier func(*types.ImageBuildOptions)
+ BuildOptionsModifier func(*build.ImageBuildOptions)🔒 Security
- deps: update testcontainers/sshd image to 1.3.0 (#3220) @mdelapenya
🚀 Features
- feat(couchbase): adding auth to couchbase initCluster functions to support container reuse (#3048) @waroir20
- feat: support adding wait strategies as functional option (#3161) @mdelapenya
- feat: add more functional options for customising containers (#3156) @mdelapenya
- feat(memcached): add memcached module (#3132) @mdelapenya
- feat(valkey): add TLS support for Valkey (#3131) @mdelapenya
🐛 Bug Fixes
- fix: strip headers from logs using log stream specification (#3226) @LaurentGoderre
- fix: use PortEndpoint() in a few more modules (#3209) @ash2k
- fix: docker container log consumer race (#3210) @stevenh
- fix: use PortEndpoint() in a few more modules (#3207) @ash2k
- fix: use PortEndpoint() in a few more modules (#3206) @ash2k
- fix: use PortEndpoint() in a few more modules (#3203) @ash2k
- fix: try to fix more IPv6 handling issues (#3198) @ash2k
- fix: workaround for moby/moby#50133 when reusing container (#3197) @mabrarov
- feat(kafka,redpanda): support for waiting for mapped ports without external checks (#3165) @mabrarov
- fix(etcd): expose ports for the etcd nodes (#3162) @mdelapenya
- fix(wait): no port to wait for (#3158) @stevenh
- fix(etcd): single node etcd cluster access (#3149) @3vilhamster
- fix(dockermodelrunner): wait for the model to be pulled (#3125) @mdelapenya
- fix(localstack): remove checksum from image name before parsing version (#3130) @trallnag
📖 Documentation
- docs: document copy from container (#3215) @mdelapenya
- docs(options): refactor options layout in modules (#3163) @mdelapenya
- docs(redpanda): update sasl authentication option to use scram sha 256 (#3126) @peczenyj
🧹 Housekeeping
- chore: clarify image auth warning message for public images (#3228) @diegolatorre16
- chore(deps): bump github.com/go-viper/mapstructure/v2 from 2.0.0 to 2.3.0 in /modules/compose (#3219) @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.28.16 to 3.29.2 (#3222) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.5 to 7.1.6 (#3225) @dependabot[bot]
- chore(exec): remove uses of ExecOptions.Detach (#3211) @thaJeztah
- chore(format): fix suggestions detected by gopls modernize (#3208) @peczenyj
- chore(deps): bump github.com/containerd/containerd/v2 from 2.0.4 to 2.0.5 in /modules/compose (#3167) @dependabot[bot]
- fix(ci): do not run sonar for Testcontainers Cloud (#3166) @mdelapenya
- chore(ci): do not fail fast in the Testcontainers Cloud run (#3164) @mdelapenya
📦 Dependency updates
- chore(deps): update go.mod in azure module (#3231) @spoonguard2k
- chore(deps): bump github.com/go-viper/mapstructure/v2 from 2.0.0 to 2.3.0 in /modules/compose (#3219) @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.28.16 to 3.29.2 (#3222) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 7.1.5 to 7.1.6 (#3225) @dependabot[bot]
- deps: update testcontainers/sshd image to 1.3.0 (#3220) @mdelapenya
- chore(deps): bump urllib3 from 2.2.2 to 2.5.0 (#3214) @dependabot[bot]
- deps: gopsutil and purego update (#3217) @pdarulewski
- chore: bump ryuk to 0.12.0 (#3195) @mdelapenya
- chore(deps)!: bump github.com/docker/docker from 28.1.1+incompatible to 28.2.2+incompatible (#3194) @mdelapenya
- chore(deps): bump github.com/containerd/containerd/v2 from 2.0.4 to 2.0.5 in /modules/compose (#3167) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 6.2.2 to 7.1.5 (#3137) @dependabot[bot]
- chore(deps): bump github.com/shirou/gopsutil/v4 from 4.25.1 to 4.25.4 (#3133) @dependabot[bot]
- chore(deps): bump github.com/docker/docker from 28.0.1+incompatible to 28.1.1+incompatible (#3152) @mdelapenya
v0.37.0
What's Changed
🔒 Security
- chore(deps): bump golang.org/x/crypto from 0.31.0 to 0.35.0 in /modules/aerospike (#3105) @dependabot[bot]
- chore(pulsar): bump github.com/apache/pulsar-client-go from 0.10.0 to 0.14.0 in /modules/pulsar (#3100) @mdelapenya
- chore(clickhouse): bump github.com/ClickHouse/clickhouse-go/v2 from 2.20.0 to 2.34.0 in /modules/clickhouse (#3099) @dependabot[bot]
- security(compose): upgrade github.com/docker/compose/v2 to fix security vulnerability (#3095) @sigi-glovebox
🚀 Features
- feat(gcloud): add option to run firestore in datastore mode (#3009) @Zarux
- feat: support for mounting images (#3044) @mdelapenya
- feat(influxdb): support for influxdbv2 (#3072) @xBlaz3kx
- feat: add
WithReuseByNamefor modifying Generic Container Requests (#3064) @jm96441n - feat(postgres): add WithOrderedInitScripts for Postgres testcontainers (#3121) @AlisCode
- feat(redis): add TLS support (#3115) @mdelapenya
- feat: add Docker Model Runner module (#3106) @mdelapenya
- feat: add toxiproxy module (#3092) @mdelapenya
- feat(aerospike): add Aerospike module (#3094) @MitulShah1
- feat: add more functional options to the modules API (#3070) @mdelapenya
- feat: add arangodb module (#3083) @mdelapenya
- feat: add socat container (#3071) @mdelapenya
🐛 Bug Fixes
- fix: handle stopped containers more gracefully when reuse is enabled (#3062) @georgespalding
- fix(mongodb): replica set initialization & connection handling (#2984) @ttruongatl
- fix(dind): use docker image load (#3073) @acouvreur
- fix(portforward): stop port-forward from the beforeStop container hook to the afterStop (#3047) @prashantv
- fix: skip nil strategies in wait.ForAll (#3032) @mdelapenya
📖 Documentation
- docs(socat): add missing version marker for new options (#3111) @mdelapenya
- docs: fix reference to container types in Run function (#3102) @mdelapenya
- docs: add dependabot configuration (#3074) @acouvreur
🧹 Housekeeping
- chore(ci): close PR if it was sent from main (#3123) @mdelapenya
- chore(ci): exclude more files for a full-blown build (#3122) @mdelapenya
- chore(ci): run core tests on Testcontainers Cloud (#3117) @mdelapenya
- chore(ci): revert codeql improvements for CI resiliency (#3112) @mdelapenya
- chore(ci): reduce GH runners usage by calling codeql in the lint stage (#3108) @mdelapenya
- chore(ci): run codeql on the modified modules (#3103) @mdelapenya
- fix(mssql): reduce flakiness in tests (#3084) @mdelapenya
- chore: bump golangci-lint to v2 (#3082) @mdelapenya
- chore(gcloud): deprecate old gcp containers, creating subpackages for them (#3063) @mdelapenya
- chore: fixed comment typo in InfluxDB (#3068) @xBlaz3kx
- chore(dind): instance of Docker in Docker (#3069) @acouvreur
📦 Dependency updates
- chore(deps): bump github/codeql-action from 3.28.15 to 3.28.16 (#3120) @dependabot[bot]
- chore(deps): bump mkdocs-include-markdown-plugin from 6.2.2 to 7.1.5 (#3119) @dependabot[bot]
- chore(deps): bump github.com/magiconair/properties from 1.8.9 to 1.8.10 (#3118) @dependabot[bot]
- deps(aerospike): replace core module in go.mod (#3116) @mdelapenya
- chore(deps): bump golang.org/x/net from 0.36.0 to 0.38.0 in /modules and /examples (#3114) @mdelapenya
- deps: use pinned dependencies on GH actions (#3110) @mdelapenya
- chore(deps): bump jinja2 from 3.1.5 to 3.1.6 (#3109) @dependabot[bot]
- deps(ci): use python 3.13 on Netlify deployments (#3107) @mdelapenya
- chore(deps): bump golang.org/x/crypto from 0.31.0 to 0.35.0 in /modules/aerospike (#3105) @dependabot[bot]
- chore(deps): bump github.com/golang-jwt/jwt/v5 from 5.2.1 to 5.2.2 in /modules/pulsar (#3101) @dependabot[bot]
- chore(pulsar): bump github.com/apache/pulsar-client-go from 0.10.0 to 0.14.0 in /modules/pulsar (#3100) @mdelapenya
- chore(clickhouse): bump github.com/ClickHouse/clickhouse-go/v2 from 2.20.0 to 2.34.0 in /modules/clickhouse (#3099) @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.28.13 to 3.28.15 (#3097) @dependabot[bot]
- chore(deps): bump golang.org/x/crypto from 0.31.0 to 0.37.0 (#3098) @dependabot[bot]
- security(compose): upgrade github.com/docker/compose/v2 to fix security vulnerability (#3095) @sigi-glovebox
- chore(deps): bump golang.org/x/net from 0.33.0 to 0.36.0 in /modules/arangodb (#3087) @dependabot[bot]
- chore(deps): bump actions/upload-artifact from 4.6.0 to 4.6.2 (#3086) @dependabot[bot]
- chore(deps): bump SonarSource/sonarqube-scan-action from 5.0.0 to 5.1.0 (#3085) @dependabot[bot]
- chore: bump golangci-lint to v2 (#3082) @mdelapenya
- chore(deps): bump docker/setup-docker-action from 4.2.0 to 4.3.0 (#3077) @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.28.12 to 3.28.13 (#3078) @dependabot[bot]
- chore(deps): bump tj-actions/changed-files from 45.0.4 to 46.0.3 (#3076) @dependabot[bot]
- chore(deps): replace
golang.org/x/exp/sliceswith stdlib (#3075) @Juneezee
v0.36.0
What's Changed
⚠️ Breaking Changes
- feat(azure)!: add Azurite, EventHubs and ServiceBus in the new Azure module, deprecating the old Azurite module (#3008) @mdelapenya
Users of the old Azurite module must update their code to use the new Azure module instead, which contains the same functionality under the
azuritesub-package.
We took this opportunity to remove the unnecessarily exportedSettingsfield from theAzuritecontainer type,
so users of theAzuritecontainer type must update their code to simply do not use that field.
- chore(deps)!: bump github.com/docker/docker from 27.1.1+incompatible to 28.0.1+incompatible (#3017) @dependabot[bot]
Bumping the Docker package to a newer major version came with lots of benefits, but also some breaking changes. For that reason, users of the following
container methods and types must update their code to use the new types and methods instead:
Container.Inspect: the return type has been changed fromtypes.ContainerJSONtocontainer.InspectResponse.Container.State: the return type has been changed fromtypes.ContainerStatetocontainer.State.DockerProvider.ContainerFromType: the method signature has been changed to accept acontainer.Summaryinstead of atypes.Container.
At the same time, if consuming Docker types or methods, users must update their code to use the new types and methods instead.
As a good rule of thumb, users of the"github.com/docker/docker/api/types"package must update their code to use"github.com/docker/docker/api/types/container"instead.
- chore!: export DockerCompose type in compose package (#2953) @jasonyunicorn
Users of the deprecated
DockerComposetype from thecomposemodule must update their code to useDockerComposerinstead.
The former unexporteddockerComposetype has been renamed toDockerCompose. This breaking change was done because returning
an un-exported type from a constructor function limits the flexibility and usability of the returned instance. Callers could use
the exported methods, but could not declare variables of that type, pass instances to other functions, or embed them in structs
without exposing the constructor itself. This breaking change was needed to improve the usability of thecomposemodule.
- feat!: log package for consistent output (#2979) @KenxinKun
Users of the
testcontainers.Loggingvariable and thetestcontainers.TestLoggerfunction must update their code to use the newlog.Default()logger instance and thelog.TestLogger()function instead, and
users of thetestcontainers.Loggerinterface must update their code to use the newlog.Loggerinterface instead.
The newlogpackage allows users to set a custom logger instance calling thelog.SetDefault(l log.Logger)function.
This breaking change was needed to improve the usability of the logging functionality when using thetestcontainerspackage.
- chore(nats)!: remove variadic arguments from nats ConnectionString (#2967) @jasonyunicorn
Users of the NATS module and the
ConnectionStringtype must remove the variadic arguments from theConnectionStringmethod. This breaking change was needed because those arguments weren't in use.
- chore!: rename EnpointSettingsModifier to EndpointSettingsModifier (#2941) @NathanBaulch
We fixed a typo in the exported field of the
ContainerRequeststruct, so users of theEnpointSettingsModifiertype must update their code to use theEndpointSettingsModifiertype instead.
🔒 Security
- chore(deps): bump golang.org/x/net from 0.23.0 to 0.36.0 in /modules/dynamodb (#3059) @mdelapenya
- chore(deps): bump golang.org/x/net from 0.23.0 to 0.36.0 in /modules/scylladb (#3058) @dependabot[bot]
- chore(deps): bump golang.org/x/net from 0.23.0 to 0.36.0 in /modules/databend (#3055) @dependabot[bot]
- chore(deps): bump golang.org/x/net from 0.26.0 to 0.33.0 (#2961) @dependabot[bot]
🚀 Features
- feat(azure)!: add Azurite, EventHubs and ServiceBus in the new Azure module, deprecating the old Azurite module (#3008) @mdelapenya
- feat(modules): add dind module (#3004) @acouvreur
- feat: add ScyllaDB module (#2992) @mdelapenya
- feat(mssql): add WithInitSQL function (#2988) @MattiasMTS
- feat(redpanda): add bootstrap user account option (#2975) @bojand
- feat!: log package for consistent output (#2979) @KenxinKun
- feat: adds Pinecone module (#2955) @mdelapenya
🐛 Bug Fixes
- fix(valkey): fix port race (#2962) @stevenh
- fix(localstack): more reliable legacy tag detection (#2936) @NathanBaulch
📖 Documentation
- docs: refine texts on how to set the module image (#3012) @mdelapenya
- docs: correct container variable (#3010) @tacerus
- docs: fix typo of grafanalgtm -> grafana-lgtm module package (#2999) @ZackarySantana
- docs: remove duplicated options in the customisers lists (#2989) @mdelapenya
🧹 Housekeeping
- chore: dockerise docs build (#3060) @mdelapenya
- fix(ci): update sonar script path in the GH actions (#3045) @mdelapenya
- chore(ci): manage Sonar projects from Github actions (#3039) @mdelapenya
- chore(sonar): set main as default branch (#3038) @mdelapenya
- fix(sonar): run on ubuntu and the lowest Go version (#3037) @mdelapenya
- fix(ci): update core path in sonar build (#3036) @mdelapenya
- fix: use empty dir for the core (#3035) @mdelapenya
- fix: pass secret to the reusable workflow (#3034) @mdelapenya
- chore(ci): use new GH action for SonarQube (#3007) @mdelapenya
- chore: readd dependabot, including a way to refresh the project files for all the modules (#2997) @mdelapenya
- chore: enable empty-block from revive (#2994) @mmorel-35
- fix(ci): exclude mkdocs.yml file and sonar.properties from the changed-modules script (#2993) @mdelapenya
- chore(ci): run compose module tests against the upstream compose projects (#2990) @mdelapenya
- chore(ci): add an end job to verify the pipeline finished with success (#2991) @mdelapenya
- chore(k6): exclude "modules/k6" from the build (#2987) @mdelapenya
- chore: enable var-naming from revive (private vars only) (#2978) @mmorel-35
- fix(ci): use same condition for sonar steps (#2974) @mdelapenya
- fix: return unique modified modules (#2973) @mdelapenya
- chore(ci): run lint in a separate build before running the tests (#2876) @mdelapenya
- chore: enable unused-parameter from revive (#2949) @mmorel-35
- chore: enable use-any from revive (#2948) @mmorel-35
- chore: enable var-declaration from revive linter (#2942) @mmorel-35
- chore: enable context-as-argument from revive linter (#2946) @mmorel-35
- chore: enable early-return, indent-error-flow and superfluous-else from revive linter (#2947) @mmorel-35
- chore: recover from panic in
SkipIfProviderIsNotHealthytest helper function (#2939) @jasonyunicorn - chore: fix typos (#2940) @NathanBaulch
📦 Dependency updates
- chore(deps): bump golang.org/x/net from 0.23.0 to 0.36.0 in /modules/dynamodb (#3059) @mdelapenya
- chore(deps): bump github.com/magiconair/properties from 1.8.7 to 1.8.9 (#3057) @dependabot[bot]
- chore(deps): bump golangci/golangci-lint-action from 6.3.0 to 6.5.2 (#3052) @dependabot[bot]
- chore(deps): bump golang.org/x/sys from 0.28.0 to 0.31.0 (#3056) @dependabot[bot]
- chore(deps): bump actions/setup-go from 5.3.0 to 5.4.0 (#3054) @dependabot[bot]
- chore(deps): bump golang.org/x/net from 0.23.0 to 0.36.0 in /modules/scylladb (#3058) @dependabot[bot]
- chore(deps): bump github/codeql-action from 3.28.11 to 3.28.12 (#3053) @dependabot[bot]
- chore(deps): bump golang.org/x/net from 0.23.0 to 0.36.0 in /modules/databend (#3055) @dependabot[bot]
- chore(deps): bump github.com/docker/buildx from 0.21.2 to 0.21.3 in /modules/compose (#3043) @dependabot[bot]
- chore(deps): bump github.com/containerd/containerd/v2 from 2.0.3 to 2.0.4 in /modules/compose (#3042) @dependabot[bot]
- deps(compose): bump compose to v2.34.0 and compose-go to v2.4.9 (#3041) @mdelapenya
- chore(deps): bump golang.org/x/net from 0.23.0 to 0.36.0 in /modules/yugabytedb (#3040) @dependabot[bot]
- chore(deps)!: bump github.com/docker/docker from 27.1.1+incompatible to 28.0.1+incompatible (#3017) @dependabot[bot]
- chore(deps): bump golang.org/x/net from 0.33.0 to 0.36.0 in /modules (#3033) @dependabot[bot]
- chore(deps): bump github.com/opencontainers/image-spec from 1.1.0 to 1.1.1, dario.cat/mergo from 1.0.0 to 1.0.1 (#3030) @mdelapenya
- chore(deps): bump github/codeql-action from 3.28.0 to 3.28.11 (#3014) @dependabot[bot]
- chore(deps): bump ossf/scorecard-action from 2.4.0 to 2.4.1 (#3013) @dependabot[bot]
- chore(modules): update Weaviate version to v1.29.0 and Weaviate Go client to v5.0.2 (#3006) @antas-marcin
- chore(deps): bump docker/setup-docker-action from 4.1.0 to 4.2.0 (#3002) @dependabot[bot]
- chore(ci): run compose module tests against the upstream compose projects (#2990) @mdelapenya
- deps: update go version from 1.22.0 to 1.23.0 (#2985) @mmorel-35
- chore(ollama): bump default version to 0.5.7 (#2966) @mdelapenya
- chore(deps): bump actions/checkout from 4.1.7 to 4.2.2 (#2971) @dependabot[bot]
- chore(deps): bump release-draf...