npm / testcontainers

testcontainers

What changed in testcontainers 11 to 12, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.

1 breaking1 deprecations17 new APIs and options7 behavior and defaults1 tooling18 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

testcontainers 1224 changes

The minimum engine requirement is now >= 22.22 because Node 20 is EOL and dependencies require it.
12.0.0release notes

Increases the timeout for waiting for host port bindings to 30 seconds.
12.2.1release notes
Only reuses reaper containers created by testcontainers-node.
12.2.1release notes
Reuses the insecure HTTP wait agent across retries.
12.0.4release notes
When an image or service has a Docker healthcheck, it is now used as the default wait strategy; otherwise, Testcontainers falls back to waiting for listening ports.
12.0.0release notes

Waits for Couchbase KV readiness before the start operation resolves.
12.2.1release notes
Starts Redpanda only after its config is in place.
12.2.1release notes
Docker log streams are closed when consumers stop reading.
12.2.0release notes
Image references pinned by tag and digest now keep the tag.
12.2.0release notes
Fixes truncation of output from container exec.
12.0.4release notes
Downgraded archiver to restore compatibility with Jest CJS.
12.0.3release notes
Fixes Couchbase service configuration.
12.0.2release notes
Fixes initial data handling for Redis and Valkey.
12.0.2release notes
Resets stateful regex log waits between matches, preventing state from carrying over between matches.
12.0.2release notes
Preserves TCP and UDP bindings when both use the same container port.
12.0.2release notes
Fixes detection of healthchecks in Podman images.
12.0.1release notes
The environment variable is now read lazily so dotenv and other runtime overrides work.
12.0.0release notes

A warning is emitted when compose wait strategy names do not match containers.
11.12.0release notes

Adds control over automatic cleanup for containers and compose environments.
11.14.0release notes
Adds an Oracle Free module for using Oracle Free with Testcontainers.
11.13.0release notes
Azurite now supports HTTPS and OAuth configuration.
11.12.0release notes
GenericContainer now supports security options.
11.12.0release notes
Postgres containers now support SSL.
11.12.0release notes
Adds an Azure Service Bus module for using Azure Service Bus with Testcontainers.
11.11.0release notes
Exports KafkaContainer's SaslSslListenerOptions for use by developers.
11.11.0release notes
The OpenSearch module adds support for disabling TLS.
11.10.0release notes
Adds support for identity token authentication.
11.9.0release notes
Adds the s3mock module.
11.8.0release notes
Adds configuration for the Ryuk reconnection timeout.
11.8.0release notes

Adds support for running in parallel when UIDs are distinct.
11.14.0release notes
Copying files into containers now follows symlinks.
11.12.0release notes
Copying archives to containers can preserve UID/GID.
11.12.0release notes

Nested .dockerignore exclusions are now honored in the Docker build context.
11.12.0release notes
A new Reaper is used when a reused Reaper is unreachable.
11.12.0release notes
Fixes asynchronous disposal of an abstract started container.
11.11.0release notes
Authenticates with identityToken when it is present in auths.
11.11.0release notes
Fixes Selenium support for a user-provided network.
11.11.0release notes
Redis containers now accept a command override.
11.8.1release notes