Testcontainers for Java

Try it in 3 steps

1. 1

   Create a pinned JUnit project

   Requires Java 17 or later, Maven, and a running Docker-compatible runtime. Create a temporary project pinned to Testcontainers 2.0.5 and JUnit.

   demo=$(mktemp -d "${TMPDIR:-/tmp}/testcontainers-java.XXXXXX") && cd "$demo" && mkdir -p src/test/java/demo && printf '%s\n' '<project xmlns="http://maven.apache.org/POM/4.0.0"><modelVersion>4.0.0</modelVersion><groupId>demo</groupId><artifactId>container-test</artifactId><version>1</version>' '<properties><maven.compiler.release>17</maven.compiler.release></properties>' '<dependencies><dependency><groupId>org.testcontainers</groupId><artifactId>testcontainers</artifactId><version>2.0.5</version><scope>test</scope></dependency><dependency><groupId>org.testcontainers</groupId><artifactId>testcontainers-junit-jupiter</artifactId><version>2.0.5</version><scope>test</scope></dependency><dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter</artifactId><version>5.11.4</version><scope>test</scope></dependency></dependencies>' '<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.14.1</version></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-surefire-plugin</artifactId><version>3.5.4</version></plugin></plugins></build></project>' > pom.xmlCopy
2. 2

   Write a disposable-container test

   Write a JUnit test that starts Alpine 3.22 for the test lifecycle and waits at most 30 seconds for its ready log.

   printf '%s\n' 'package demo;' 'import org.junit.jupiter.api.Test;' 'import org.testcontainers.containers.GenericContainer;' 'import org.testcontainers.junit.jupiter.Container;' 'import org.testcontainers.junit.jupiter.Testcontainers;' 'import org.testcontainers.containers.wait.strategy.Wait;' 'import java.time.Duration;' 'import org.testcontainers.utility.DockerImageName;' 'import static org.junit.jupiter.api.Assertions.assertTrue;' '@Testcontainers class ContainerTest {' ' @Container static GenericContainer<?> alpine = new GenericContainer<>(DockerImageName.parse("alpine:3.22")).withCommand("sh","-c","echo ready; sleep 30").waitingFor(Wait.forLogMessage(".*ready.*\n",1).withStartupTimeout(Duration.ofSeconds(30)));' ' @Test void capturesContainerOutput() { assertTrue(alpine.getLogs().contains("ready")); }' '}' > src/test/java/demo/ContainerTest.javaCopy
3. 3

   Verify container output

   Run the JUnit test and require ready in the container log. Testcontainers manages disposal at the end of the test.

   mvn -q -Dtest=ContainerTest testCopy

Built with

• Java
• Docker

Categories and tags

GitHub data

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Explore next

• Karate8,974 Stars

  1 shared tag(s) · 1 shared category(s) · Same language

  combine API tests, mock servers, and performance tests in one Gherkin-style framework

  Java
• Playwright97,099 Stars

  1 shared tag(s) · 1 shared category(s)

  Drive Chromium, Firefox, and WebKit through one API and test runner for E2E, scripting, and agent browser automation

  TypeScript
• Storybook91,200 Stars

  1 shared tag(s) · 1 shared category(s)

  capture UI states once and reuse them across docs, interaction tests, and agent tooling

  TypeScript
• Hoppscotch80,566 Stars

  1 shared tag(s) · 1 shared category(s)

  Span REST, GraphQL, realtime requests, and collection tests across web, desktop, CLI, and self-hosted API workflows

  TypeScript
• Cypress51,042 Stars

  1 shared tag(s) · 1 shared category(s)

  run browser end-to-end and component tests through an interactive runner and CLI

  TypeScript
• Jest45,500 Stars

  1 shared tag(s) · 1 shared category(s)

  Combine assertions, mocks, watch mode, snapshots, coverage, and worker isolation in one JavaScript test runner

  TypeScript