v11.3.1

Changes

🐛 Bug Fixes

• Fix for Gcloud module eagerly importing @google-cloud/spanner @cristianrgreco (#1084)

v11.3.0

Changes

🚀 Features

• Implement AsyncDisposable to support TS 5.2's using @cristianrgreco (#1080)
• Add Spanner module @JohanObrink (#1076)
• Add HashiCorp Vault module @inf1nite-lo0p (#1079)
• Add Opensearch module @JohanObrink (#1072)

🧹 Maintenance

• Bump ryuk and sshd image versions @digital88 (#1063)

📦 Dependency Updates

• Bump the dependencies group across 4 directories with 4 updates @dependabot[bot] (#1074)

v11.2.1

Changes

🐛 Bug Fixes

• Fix undici response parsing when status code says no content but there is content @cristianrgreco (#1062)

v11.2.0

Changes

🚀 Features

• Add getSecureUrl in mockserver's module @botflux (#1059)
• Add support for Confluent Kafka 8 @cristianrgreco (#1053)

🧹 Maintenance

• Add mkdocs + devcontainers to dependabot @cristianrgreco (#1054)

📦 Dependency Updates

• Bump the dependencies group across 11 directories with 11 updates @dependabot[bot] (#1061)
• Bump the dependencies group with 4 updates @dependabot[bot] (#1056)
• Bump python from 3.8 to 3.13 in the dependencies group @dependabot[bot] (#1057)
• Bump the dependencies group across 6 directories with 6 updates @dependabot[bot] (#1055)
• Bump the dependencies group across 1 directory with 22 updates @dependabot[bot] (#1052)

v11.1.0

Changes

🚀 Features

• Add support for custom client options in DockerComposeEnvironment @Dyskal (#1044)
• Change KurrentDB protocol from esdb to kurrentdb @botflux (#1051)

v11.0.3

Changes

🐛 Bug Fixes

• Increase timeout for waiting for host port bindings @cristianrgreco (#1038)

📦 Dependency Updates

• Bump the dependencies group across 2 directories with 21 updates @dependabot[bot] (#1034)
• Bump the dependencies group across 7 directories with 7 updates @dependabot[bot] (#1037)

v11.0.2

Changes

🐛 Bug Fixes

• Handle case where container port does not exist in inspect result @cristianrgreco (#1036)

v11.0.1

🐛 Bug Fixes

• Retry inspecting container until exposed ports are mapped @cristianrgreco (#1032)

📦 Dependency Updates

• Bump the dependencies group across 4 directories with 4 updates @dependabot[bot] (#1026)
• Bump the dependencies group across 28 directories with 28 updates @dependabot[bot] (#1021)
• Bump the dependencies group across 5 directories with 7 updates @dependabot[bot] (#1022)

v11.0.0

🚨 Breaking Changes

---

1. Minimum Node engine requirement set to 20.

---

2. Default module images have been removed.

Previously:

await new PostgreSqlContainer().start();

Now:

await new PostgreSqlContainer("postgres:13.3-alpine").start();

For convenience, here is a table of all the previous default values, which you could just copy/paste to get back working again, but have a think about which version you actually need. Some of these are quite old and need to be updated.

Default module images

Module	Image
arangodb	arangodb:3.10.0
azurecosmosdb	mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-EN20250228
azurite	mcr.microsoft.com/azure-storage/azurite:3.33.0
cassandra	cassandra:5.0.2
chromadb	chromadb/chroma:0.6.3
clickhouse	clickhouse/clickhouse-server:25.3-alpine
cockroachdb	cockroachdb/cockroach:v24.3.5
couchbase	couchbase/server:6.5.1
elasticsearch	elasticsearch:7.17.7
etcd	quay.io/coreos/etcd:v3.6.0
eventstoredb	eventstore/eventstore:24.10
gcloud	gcr.io/google.com/cloudsdktool/cloud-sdk:517.0.0-emulators
hivemq	hivemq/hivemq-ce:2023.5
k3s	rancher/k3s:v1.31.2-k3s1
kafka	confluentinc/cp-kafka:7.2.2
localstack	localstack/localstack:2.2.0
mariadb	mariadb:11.5.2
minio	minio/minio:RELEASE.2024-12-13T22-19-12Z
mockserver	mockserver/mockserver:5.15.0
mongodb	mongo:4.0.1
mssqlserver	mcr.microsoft.com/mssql/server:2022-CU13-ubuntu-22.04
mysql	mysql:8.0.31
nats	nats:2.8.4-alpine
neo4j	neo4j:4.4.12
ollama	ollama/ollama:0.1.44
postgresql	postgres:13.3-alpine
qdrant	qdrant/qdrant:v1.13.4
rabbitmq	rabbitmq:3.12.11-management-alpine
redis	redis:7.2
redpanda	docker.redpanda.com/redpandadata/redpanda:v23.3.10
scylladb	scylladb/scylla:6.2.0
selenium	selenium/standalone-chrome:112.0
toxiproxy	ghcr.io/shopify/toxiproxy:2.11.0
valkey	valkey/valkey:8.0
weaviate	semitechnologies/weaviate:1.24.5

---

3. Dropped support for Docker Compose v1 (EOL July 2023).

---

4. Docker compose version no longer available via ComposeClient

const { compose } = await getContainerRuntimeClient();
compose.version; // no longer available

---

5. Container stop timeouts have changed from seconds to milliseconds

Previously:

await container.stop({ timeout: 10 }); // 10 seconds

Now:

await container.stop({ timeout: 10_000 }); // 10 seconds

---

6. EventStoreDB has been renamed to KurrentDB

Previously:

import { EventStoreDBContainer } from "@testcontainers/eventstoredb";
new EventStoreDBContainer("eventstore/eventstore:24.10").start();

Now:

import { KurrentDbContainer } from "@testcontainers/kurrentdb";
new KurrentDbContainer("kurrentplatform/kurrentdb:25.0").start();

---

7. RandomUniquePortGenerator replaced by RandomPortGenerator

---

Changes

🧹 Maintenance

• Refactor workflows @cristianrgreco (#1016)
• Add dependabot @cristianrgreco (#1013)
• Rename EventStoreDB to KurrentDB @botflux (#901)
• Don't log compose version to improve startup performance @cristianrgreco (#1012)
• Container stop timeouts should be in milliseconds @digital88 (#962)
• Remove default images + Min node version 20 @cristianrgreco (#938)

📦 Dependency Updates

• Bump the dependencies group across 3 directories with 27 updates @dependabot[bot] (#1015)
• Bump the actions group with 3 updates @dependabot[bot] (#1014)

v10.28.0

Changes

🚀 Features

• NATS: Add codec, scratch compatibility @joebowbeer (#1011)
• Add support for redis-stack containers @crcarlo (#1005)

🐛 Bug Fixes

• Export container classes from the Etcd module @prenaissance (#1007)

🧹 Maintenance

• Upgrade NATS library used for tests @jdinsel-xealth (#1009)
• Pin gcloud cloud-sdk image version @cristianrgreco (#1010)