Unclaimed project
Are you a maintainer of testcontainers-java ? Claim this project to take control of your public changelog and roadmap.
Claim this project Changelog
testcontainers-java Testcontainers is a Java library that supports JUnit tests, providing lightweight, throwaway instances of common databases, Selenium web browsers, or anything else that can run in a Docker container.
Β© 2026 AnnounceHQ. All rights reserved.
Testcontainers 2.0.0
Main changes
Removed JUnit 4 support
Updated transitive dependencies
All modules are now prefixed with testcontainers-. For example, org.testcontainers:mysql is now org.testcontainers:testcontainers-mysql
Container classes relocated to org.testcontainers.<module-name> package. For example, new MySQLContainer class is under org.testcontainers.mysql
What's Changed
Add support for ComposeContainer with Spock (#11109) @eddumelendez
org.testcontainers.mysql.MySQLContainer do not copy default config (#11107) @eddumelendez
org.testcontainers.mariadb.MariaDBContainer do not copy default config (#11108) @eddumelendez
Remove org.testcontainers.neo4j.Neo4jContainer#withEnterpriseEdition (#11106) @eddumelendez
Move CassandraDatabaseDelegate and CassandraQueryWaitStrategy to org.testcontainers.cassandra (#11105) @eddumelendez
Switch to com.mysql:mysql-connector-j (#11078) @rajucomp
Fix missing junit4 leftovers (#10808) @eddumelendez
2.0.0 - testcontainers-java Release Notes | AnnounceHQ
Move Selenium tests to JUnit Jupiter (#10804) @eddumelendez
Move Testcontainers tests to JUnit Jupiter (#10803) @eddumelendez
Move Toxiproxy tests to JUnit Jupiter (#10757) @vlsi
Replace deprecated XmlSlurper with groovy.xml.XmlSlurper (#10801) @eddumelendez
Update spring boot version to 3.5.6 in selenium example (#10797) @eddumelendez
Skip databend module in CI (#10793) @eddumelendez
Move database tests to JUnit Jupiter (#10786) @eddumelendez
Move missing K3s tests to JUnit Jupiter (#10785) @eddumelendez
Move database-commons tests to JUnit Jupiter (#10772) @eddumelendez
Move R2DBC tests to JUnit Jupiter (#10771) @eddumelendez
Move JDBC tests to JUnit Jupiter (#10770) @eddumelendez
Move Weaviate tests to JUnit Jupiter (#10769) @eddumelendez
Move Vault tests to JUnit Jupiter (#10768) @eddumelendez
Move Solace assertions to assertj (#10765) @eddumelendez
Move Solace tests to JUnit Jupiter (#10764) @eddumelendez
Move ScyllaDB tests to JUnit Jupiter (#10763) @eddumelendez
Move RabbitMQ tests to JUnit Jupiter (#10761) @eddumelendez
Move Redpanda tests to JUnit Jupiter (#10762) @eddumelendez
Move Qdrant tests to JUnit Jupiter (#10760) @eddumelendez
Move Pulsar tests to JUnit Jupiter (#10759) @eddumelendez
Move Pinecone tests to JUnit Jupiter (#10758) @eddumelendez
Move OrientDB tests to JUnit Jupiter (#10755) @eddumelendez
Move OpenFGA tests to JUnit Jupiter (#10754) @eddumelendez
Move Ollama tests to JUnit Jupiter (#10753) @eddumelendez
Move Nginx tests to JUnit Jupiter (#10752) @eddumelendez
Move Neo4j tests to JUnit Jupiter (#10751) @eddumelendez
Move MongoDB tests to JUnit Jupiter (#10750) @eddumelendez
Move MockServer tests to JUnit Jupiter (#10749) @eddumelendez
Move MinIO tests to JUnit Jupiter (#10748) @eddumelendez
Move Milvus tests to JUnit Jupiter (#10747) @eddumelendez
Move LocalStack tests to JUnit Jupiter (#10746) @eddumelendez
Update ryuk version to 0.13.0 (#10745) @eddumelendez
Move LDAP tests to JUnit Jupiter (#10744) @eddumelendez
Move Kafka tests to JUnit Jupiter (#10743) @eddumelendez
Move K6 tests to JUnit Jupiter (#10742) @eddumelendez
Move K3s tests to JUnit Jupiter (#10741) @eddumelendez
Move InfluxDB tests to JUnit Jupiter (#10738) @eddumelendez
Move Grafana tests to JUnit Jupiter (#10737) @eddumelendez
Move GCloud tests to JUnit Jupiter (#10736) @eddumelendez
Move Elasticsearch tests to JUnit Jupiter (#10735) @eddumelendez
Move Couchbase tests to JUnit Jupiter (#10734) @eddumelendez
Move Consul tests to JUnit Jupiter (#10732) @eddumelendez
Move ChromaDB tests to JUnit Jupiter (#10730) @eddumelendez
Move Cassandra tests to JUnit Jupiter (#10728) @eddumelendez
Move Azure tests to JUnit Jupiter (#10727) @eddumelendez
Move ActiveMQ tests to JUnit Jupiter (#10726) @eddumelendez
Add testcontainers prefix to modules (#10591) @eddumelendez
Use azure-sdk-bom (#10480) @eddumelendez
Update Weaviate to v1.29.0 (#10066) @antas-marcin
[Bug]: SolaceContainer misses permissions when using non-default VPN β¦ (#10450) @infoShare
Remove dynalite module (#10384) @eddumelendez
Move cucumber example to junit5 (#10383) @eddumelendez
β οΈ Breaking API changes
Add support for specifying Docker image in DockerComposeContainer and ComposeContainer (#9871) @fokion
Remove JUnit 4 support (#10805) @eddumelendez
Make Neo4jContainer generic and drop deprecated method (#10388) @eddumelendez
Drop module's default constructors (#10385) @eddumelendez
Remove LinkableContainer from NginxContainer (#10386) @eddumelendez
π Features & Enhancements
Expose gRPC endpoint from BigQueryEmulator (#10779) @Eliassen-Steinar
Add method getHttpUrl for ClickHouseContainer (#10526) @sbushmelev
π Bug Fixes
Fix Kafka listeners and advertised listeners config to come out of sync (#11068) @ThomasKasene
Fix support to set a custom database name in Host-less JDBC urls (#10603) @maxhov
Make MySQLContainer compatible with mysql:9.3.0 (#10185) @livk-cloud
π Documentation
Fix CassandraContainer wait strategy when SSL is configured (#9419) @maximevw
Add Solr container implementation under org.testcontainers.solr (#11104) @eddumelendez
Add OrientDB container implementation under org.testcontainers.orientdb (#11098) @eddumelendez
Add Neo4J container implementation under org.testcontainers.neo4j (#11097) @eddumelendez
Add Selenium container implementation under org.testcontainers.selenium (#11096) @eddumelendez
Add MongoDB container implementation under org.testcontainers.mongodb (#11095) @eddumelendez
Add DB2 container implementation under org.testcontainers.db2 (#11094) @eddumelendez
Move TiDB tests under org.testcontainers.tidb (#11093) @eddumelendez
Add Trino container implementation under org.testcontainers.trino (#11092) @eddumelendez
Add Toxiproxy container implementation under org.testcontainers.toxiproxy (#11091) @eddumelendez
Add RabbitMQ container implementation under org.testcontainers.rabbitmq (#11090) @eddumelendez
Add Pulsar container implementation under org.testcontainers.pulsar (#11089) @eddumelendez
Add PostgreSQL container implementation under org.testcontainers.postgresql (#11088) @eddumelendez
Add Nginx container implementation under org.testcontainers.nginx (#11087) @eddumelendez
Add MySQL container implementation under org.testcontainers.mysql (#11086) @eddumelendez
Add MSSQLServer container implementation under org.testcontainers.mssqlserver (#11085) @eddumelendez
Add MockServer container implementation under org.testcontainers.mockserver (#11084) @eddumelendez
Add MariaDB container implementation under org.testcontainers.mariadb (#11083) @eddumelendez
Add LocalStack container implementation under org.testcontainers.localstack (#11082) @eddumelendez
Add GCloud container implementations under org.testcontainers.gcloud (#11081) @eddumelendez
Add CockroachDB container implementation under org.testcontainers.cockroachdb (#11080) @eddumelendez
Removing doc examples of the deprecated kafka container (#10712) @etrandafir93
Add Testcontainers JDBC URL section to modules (#10609) @eddumelendez
Fix JDBC docs (#10608) @eddumelendez
Improve database docs (#10607) @eddumelendez
Fix redpanda docs link (#10606) @eddumelendez
Fix grafana docs (#10605) @eddumelendez
Move localstack's tests to aws sdk v2 (#10592) @eddumelendez
π§Ή Housekeeping
Centralize junit jupiter and assertj dependencies (#11067) @eddumelendez
Fix javadoc ConfluentKafkaContainer.java (#10714) @gusega
Remove httpclient5 dependency from clickhouse (#10610) @eddumelendez
Fix parameter check in Kafka cluster examples (#10361) @winfriedgerlach
Implement AutoCloseable for TestcontainersExtension$StoreAdapter (#10529) @linghengqian
Use rest-assured in mockserver module (#10523) @eddumelendez
Restore JibTest (#10520) @eddumelendez
Remove support for docker/agents_gateway (#10473) @eddumelendez
π¦ Dependency updates
46 changes
Combined dependencies PR (#11077) @eddumelendez
Combined dependencies PR (#11076) @eddumelendez
Combined dependencies PR (#11075) @eddumelendez
Combined dependencies PR (#11071) @eddumelendez
Combined dependencies PR (#11070) @eddumelendez
Combined dependencies PR (#11069) @eddumelendez
Combined dependencies PR (#10800) @eddumelendez
Combined dependencies PR (#10798) @eddumelendez
Combined dependencies PR (#10722) @eddumelendez
Combined dependencies PR (#10721) @eddumelendez
Combined dependencies PR (#10720) @eddumelendez
Combined dependencies PR (#10717) @eddumelendez
Combined dependencies PR (#10716) @eddumelendez
Combined dependencies PR (#10715) @eddumelendez
Combined dependencies PR (#10709) @eddumelendez
Combined dependencies PR (#10602) @eddumelendez
Update clickhouse version to 0.9.1 (#10593) @eddumelendez
Move localstack's tests to aws sdk v2 (#10592) @eddumelendez
Combined dependencies PR (#10589) @eddumelendez
Combined dependencies PR (#10587) @eddumelendez
Combined dependencies PR (#10560) @eddumelendez
Combined dependencies PR (#10559) @eddumelendez
Remove junit-toolbox dependency (#10522) @eddumelendez
Combined dependencies PR (#10521) @eddumelendez
Combined dependencies PR (#10519) @eddumelendez
Update jackson, snakeyaml and docker-java versions (#10258) @ZachChuba
Update org.questdb:questdb version to 9.0.0 (#10486) @eddumelendez
Update com.google.cloud:libraries-bom version to 26.63.0 (#10485) @eddumelendez
Combined dependencies PR (#10484) @eddumelendez
Combined dependencies PR (#10483) @eddumelendez
Combined dependencies PR (#10482) @eddumelendez
Combined dependencies PR (#10481) @eddumelendez
Combined dependencies PR (#10474) @eddumelendez
Combined dependencies PR (#10472) @eddumelendez
Combined dependencies PR (#10471) @eddumelendez
Combined dependencies PR (#10469) @eddumelendez
Combined dependencies PR (#10468) @eddumelendez
Combined dependencies PR (#10467) @eddumelendez
Combined dependencies PR (#10466) @eddumelendez
Combined dependencies PR (#10464) @eddumelendez
Combined dependencies PR (#10463) @eddumelendez
Combined dependencies PR (#10462) @eddumelendez
Combined dependencies PR (#10460) @eddumelendez
Combined dependencies PR (#10459) @eddumelendez
Combined dependencies PR (#10456) @eddumelendez
Update Gradle Wrapper from undefined to 8.14.3 (#10452) @github-actions[bot]