Getting started with Testcontainers for Java

In this guide, you will learn how to:

• Create a Java project with Maven
• Implement a CustomerService that manages customer records in PostgreSQL
• Write integration tests using Testcontainers with a real Postgres database
• Run the tests and verify everything works

Prerequisites

• Java 17+
• Maven or Gradle
• A Docker environment supported by Testcontainers

Note

If you're new to Testcontainers, visit the Testcontainers overview to learn more about Testcontainers and the benefits of using it.

Modules

1. Create the project

   Set up a Java project with Maven and implement a PostgreSQL-backed customer service.

2. Write tests

   Write your first integration test using Testcontainers for Java and PostgreSQL.

3. Run tests

   Run your Testcontainers-based integration tests and explore next steps.