v12.0.1

Changes

🐛 Bug Fixes

• Fix Podman image healthcheck detection @cristianrgreco (#1341)

🧹 Maintenance

• Add npm dependency release age cooldown @cristianrgreco (#1339)
• Use Docker Hub Redpanda image @cristianrgreco (#1342)
• Use preinstalled Podman in checks @cristianrgreco (#1334)
• Simplify affected package checks @cristianrgreco (#1326)
• Add npm publish dry run workflow @cristianrgreco (#1333)
• Upgrade build agents from Ubuntu 22.04 to 24.04 @cristianrgreco (#986)
• Improve module compile checks @cristianrgreco (#1327)

📦 Dependency Updates

• Bump tmp from 0.2.5 to 0.2.6 @dependabot[bot] (#1343)
• Bump the dependencies group across 14 directories with 16 updates @dependabot[bot] (#1344)
• Bump the dependencies group with 13 updates @dependabot[bot] (#1338)
• Bump the dependencies group across 13 directories with 12 updates @dependabot[bot] (#1328)
• Bump the dependencies group across 1 directory with 22 updates @dependabot[bot] (#1331)

v12.0.0

🚨 Breaking Changes

1. Node 20 is EOL. Minimum engine requirement is now >= 22.22, matching the constraints from our dependencies.

2. Previously, when no wait strategy was configured, Testcontainers defaulted to Wait.forListeningPorts().

   The new default wait strategy uses a Docker healthcheck when one is configured on the container image or service, falling back to Wait.forListeningPorts() when no healthcheck is available.

   To keep the previous behaviour, configure Wait.forListeningPorts() explicitly:

   import { DockerComposeEnvironment, GenericContainer, Wait } from "testcontainers";
   
   // Container: opt back into the previous default of waiting for listening ports
   const container = await new GenericContainer("my-image:latest")
     .withExposedPorts(8080)
     .withWaitStrategy(Wait.forListeningPorts())
     .start();
   
   // Compose: apply the previous default to all services
   const environment = await new DockerComposeEnvironment(composeFilePath, "docker-compose.yml")
     .withDefaultWaitStrategy(Wait.forListeningPorts())
     .up();
   
   // Compose: or apply it to a specific compose container
   const environment = await new DockerComposeEnvironment(composeFilePath, "docker-compose.yml")
     .withWaitStrategy("api-1", Wait.forListeningPorts())
     .up();

---

Changes

🚀 Features

• Use configured health checks as the default wait strategy @digital88 (#1096)

🐛 Bug Fixes

• Read RYUK_CONTAINER_IMAGE lazily so dotenv / other runtime overrides work @dvirarad (#1323)
• Use /tmp for Kafka startup script @cristianrgreco (#1302)

📖 Documentation

• Clarify PR defaults in AGENTS.md @cristianrgreco (#1303)

🧹 Maintenance

• Repair npm publish version updates @cristianrgreco (#1330)

📦 Dependency Updates

• Bump ghcr.io/devcontainers/features/node from 1.7.1 to 2.0.0 in the dependencies group @dependabot[bot] (#1318)
• Bump the dependencies group across 18 directories with 20 updates @dependabot[bot] (#1321)
• Bump the dependencies group across 1 directory with 30 updates @dependabot[bot] (#1322)
• Bump the dependencies group across 1 directory with 23 updates @dependabot[bot] (#1300)
• Bump the dependencies group across 16 directories with 18 updates @dependabot[bot] (#1299)

v11.14.0

Changes

🚀 Features

• Add auto cleanup control for containers and compose environments @cristianrgreco (#1293)
• Add support for running in parallel for distinct UIDs @seanwu1105 (#1276)

📖 Documentation

• Document LocalStack authentication requirements @cristianrgreco (#1295)

🧹 Maintenance

• Only include TS files in test coverage paths @cristianrgreco (#1294)
• Fix etcd/vault repository.url in package.json @cristianrgreco (#1273)

📦 Dependency Updates

• Bump the dependencies group across 14 directories with 13 updates @dependabot[bot] (#1289)
• Bump the dependencies group across 1 directory with 21 updates @dependabot[bot] (#1287)
• Bump mkdocs-material from 9.7.5 to 9.7.6 in the dependencies group @dependabot[bot] (#1278)
• Bump the dependencies group across 11 directories with 10 updates @dependabot[bot] (#1279)
• Bump the dependencies group with 19 updates @dependabot[bot] (#1280)

v11.13.0

Changes

🚀 Features

• Add Oracle Free module @collinmurd (#1242)

📖 Documentation

• Improve AGENTS.md monorepo and PR-authoring guidance @cristianrgreco (#1265)
• Restore search input after Material for MkDocs v9 update @HofmeisterAn (#1259)
• Fix Vitest global setup quickstart for Redis @cristianrgreco (#1245)

🧹 Maintenance

• Disable sourcemap emission to avoid missing source warnings @tmm (#1268)
• NPM audit @cristianrgreco (#1266)
• Move Vault test client from node-vault to @litehex/node-vault @cristianrgreco (#1263)
• Allow couchbase patch version updates @cristianrgreco (#1251)
• Exempt never-stale issues from stale workflow @cristianrgreco (#1241)
• Add stale issue workflow @cristianrgreco (#1240)

📦 Dependency Updates

• Bump mkdocs-material from 9.7.4 to 9.7.5 in the dependencies group @dependabot[bot] (#1269)
• Bump the dependencies group across 9 directories with 10 updates @dependabot[bot] (#1271)
• Bump the dependencies group with 16 updates @dependabot[bot] (#1272)
• Bump the dependencies group with 11 updates @dependabot[bot] (#1262)
• Bump the dependencies group across 8 directories with 8 updates @dependabot[bot] (#1261)
• Bump mkdocs-material from 9.7.3 to 9.7.4 in the dependencies group @dependabot[bot] (#1260)
• Bump the dependencies group across 1 directory with 22 updates @dependabot[bot] (#1257)
• Bump the dependencies group across 11 directories with 12 updates @dependabot[bot] (#1255)
• Bump mkdocs-material from 9.7.2 to 9.7.3 in the dependencies group @dependabot[bot] (#1254)
• Bump the dependencies group across 8 directories with 9 updates @dependabot[bot] (#1248)
• Bump the dependencies group with 2 updates @dependabot[bot] (#1247)

v11.12.0

Changes

🚀 Features

• Add SSL support for postgres containers @cristianrgreco (#1224)
• Add Azurite support for HTTPS/OAuth configuration @cristianrgreco (#1228)
• Support preserving UID/GID when copying archives to containers @cristianrgreco (#1234)
• Follow symlinks when copying files into containers @cristianrgreco (#1235)
• Warn when compose wait strategy names don't match containers @cristianrgreco (#1232)
• Add support for GenericContainer security options @cristianrgreco (#1226)

🐛 Bug Fixes

• Honor nested .dockerignore exclusions in Docker build context @cristianrgreco (#1229)
• Fallback to new Reaper when reused Reaper is unreachable @cristianrgreco (#1233)

📖 Documentation

• Add AGENTS.md: #1225
• Update AGENTS.md: #1236, #1231, #1227

🧹 Maintenance

• Restore compose warning test compile after naming simplification @cristianrgreco (#1239)
• Simplify Docker Compose naming to v2-only format @cristianrgreco (#1238)
• Docker event stream test helper matches both status and Action fields @cristianrgreco (#1230)

📦 Dependency Updates

• Bump dependencies: #1222, #1223, #1220, #1221, #1212, #1211, #1208, #1209
• Bump mkdocs-material: #1205

v11.11.0

Changes

🚀 Features

• Add Azure Service Bus module @UnstoppableMango (#1194)

🐛 Bug Fixes

• Selenium support user-provided network @AlexSanin (#1207)
• Fix abstract started container async dispose @joebowbeer (#1203)
• Authenticate with identityToken when present in auths @jwhite-sds (#1197)

🧹 Maintenance

• Export KafkaContainer's SaslSslListenerOptions @joebowbeer (#1201)
• Update Kafka module markdown and ZK test version @joebowbeer (#1198)

📦 Dependency Updates

• Bump the dependencies group across 16 directories with 18 updates @dependabot[bot] (#1200)
• Bump the dependencies group with 12 updates @dependabot[bot] (#1199)

v11.10.0

Changes

🚀 Features

• Add support for disabling TLS in OpenSearch module @rafaeltab (#1193)

🧹 Maintenance

• Migrate kafkajs to @confluentinc/kafka-javascript @joebowbeer (#1192)

📦 Dependency Updates

• Bump the dependencies group across 5 directories with 6 updates @dependabot[bot] (#1190)
• Bump the dependencies group across 1 directory with 15 updates @dependabot[bot] (#1195)

v11.9.0

Changes

🚀 Features

• Add support for identity token authentication @cristianrgreco (#1179)

📦 Dependency Updates

• Bump the dependencies group across 21 directories with 23 updates @dependabot[bot] (#1187)
• Bump mkdocs-material from 9.6.23 to 9.7.0 in the dependencies group @dependabot[bot] (#1186)

v11.8.1

Changes

🐛 Bug Fixes

• Fix Redis container to accept command override @ziggornif (#1155)

📦 Dependency Updates

• Bump the dependencies group with 10 updates @dependabot[bot] (#1176)
• Bump mkdocs-material from 9.6.22 to 9.6.23 in the dependencies group @dependabot[bot] (#1178)
• Bump the dependencies group across 28 directories with 31 updates @dependabot[bot] (#1177)

v11.8.0

Changes

🚀 Features

• Add configuration for TESTCONTAINERS_RYUK_RECONNECTION_TIMEOUT @abendi (#1168)
• Add s3mock module @nikeee (#1170)

📦 Dependency Updates

• Bump the dependencies group across 5 directories with 9 updates @dependabot[bot] (#1103)
• Bump the dependencies group across 1 directory with 26 updates @dependabot[bot] (#1173)
• Bump python from 3.13 to 3.14 in the dependencies group @dependabot[bot] (#1159)
• Bump mkdocs-material from 9.6.20 to 9.6.21 in the dependencies group @dependabot[bot] (#1157)