NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4531 most downloaded on npm
Testcontainers is a NodeJS library that supports tests, providing lightweight, throwaway instances of common databases, Selenium web browsers, or anything else that can run in a Docker container
Last release 6 days ago
28 Sep 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
9 years old
299 releases · first in 2018
Log docker-compose diagnostics @cristianrgreco
Use host-port wait strategy of the Reaper @cristianrgreco
One column per quarter.
Increase Reaper socket verbosity @cristianrgreco
Output daemon container logs @cristianrgreco
## Changes ## 🧹 Maintenance - Update deps @cristianrgreco
Add network aliases @cristianrgreco
Provide registry authorisation when building Dockerfile @cristianrgreco
Add support for TESTCONTAINERS\_DOCKER\_SOCKET\_OVERRIDE for ryuk @cristianrgreco
Improve docker config auth loader registry matching @crickford
Enable the use of credentials for images pulled from dockerhub @crickford
Fix TS build issue #197 @kincaidoneil
Reaper should clean up images @cristianrgreco
Implement providing IPC mode @cristianrgreco
Port host override feature from testcontainers-java @alexeagle
Port allocation doesn't work well, when containers are created by jest @xxBedy
Down and throw if DockerComposeEnvironment wait strategy fails @cristianrgreco
DockerComposeEnvironment wait strategy fails @cristianrgreco (#188)Support environment variables in a docker-compose file @cristianrgreco
Propagate a clear error when a container with LogWaitStrategy fails @dmitri-gb
Add ability to copy files to a container before it is started @dmitri-gb
Return empty DockerConfig if no .docker/config.json file @cristianrgreco
DockerConfig if no .docker/config.json file @cristianrgreco (#182)Signature change: new GenericContainer('image', 'tag') => new GenericContainer('image:tag') The reason for this is to support providing an optional re
new GenericContainer('image', 'tag') => new GenericContainer('image:tag')
The reason for this is to support providing an optional registry, eg. new GenericContainer('registry/image:tag')withAuthentication method has been removed.
Authentication is now automatically resolved from $HOME/.docker/config.jsonFix incorrect parsing of image name @cristianrgreco
## Changes ## 🧹 Maintenance - Update deps @cristianrgreco
Support custom sshd image @cristianrgreco
Add possibility to specify custom ryuk image @sirdir
Allow passing custom Kafka and ZK images @cristianrgreco
Use ssh-remote-port-forward lib @cristianrgreco
Expose host ports to container @cristianrgreco
getContainerIpAddress() has been renamed to getHost()
getContainerIpAddress() has been renamed to getHost()Support providing multiple docker-compose files @cristianrgreco
node-duration has been removed and replaced with primitive number types; the unit used everywhere is milliseconds.
milliseconds.Before:
new Duration(1, TemporalUnit.SECONDS)
After:
1000
Log wait strategy supports regex @cristianrgreco
Support disabling the ryuk container @cristianrgreco
## Changes ## 🚀 Features - Fix Windows @cristianrgreco (#147) ## 🐛 Bug Fixes - Fix Windows @cristianrgreco (#147) ## 🧹 Maintenance - Fix Windows @cris
Add elasticsearch module @matthewbpt
Remove docker-compose volumes on down @cristianrgreco
Fix containers left running after wait strategies fail @cristianrgreco
Add support for stopping a docker-compose environment @cristianrgreco
Nothing published for this version
Nothing published for this version
Mount unix socket into Reaper if it exists, with DOCKER_HOST fallback @cristianrgreco
Migrate tslint to eslint @cristianrgreco
Fix Reaper not using DOCKER_HOST if set @cristianrgreco
Nothing published for this version
Change type of logs to Readable @cristianrgreco
Reaper host should be Docker host @cristianrgreco
Reaper must be run with privileged mode @cristianrgreco
Default timeout for container.stop()changed from 10s to 0.
container.stop()changed from 10s to 0.KafkaContainer now returns an instance of a StartedKafkaContainer, which when stopped, shuts down any self-managed networks/zoo keeper containers.Show Docker pull output @cristianrgreco
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add ArangoDB module https://github.com/testcontainers/testcontainers-node/pull/112
Update Neo4j README https://github.com/testcontainers/testcontainers-node/pull/111
https://github.com/testcontainers/testcontainers-node/pull/110 - Add Neo4j module
https://github.com/testcontainers/testcontainers-node/pull/110 - Add Neo4j module
https://github.com/testcontainers/testcontainers-node/issues/107
https://github.com/testcontainers/testcontainers-node/issues/105
https://github.com/testcontainers/testcontainers-node/issues/74
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →