Skip to content

Testcontainers

What is Testcontainers?

Testcontainers is a set of open source libraries that provides easy and lightweight APIs for bootstrapping local development and test dependencies with real services wrapped in Docker containers. Using Testcontainers, you can write tests that depend on the same services you use in production without mocks or in-memory services.

Implementations

Docker-sponsored Projects

Community Projects

Modules Catalog

Testcontainers offers modules with preconfigured implementations for popular services such as databases, message brokers, and more. Find the full list of modules in the Testcontainers Module Catalog. If you own a Testcontainers module implementation, please submit it to the catalog by creating a pull request to this repository.

Getting Started

To get started with Testcontainers, please refer to the What is Testcontainers, and why should you use it? guide. We recommend you to start with the Getting Started guide.

How to start?

Testcontainers Desktop

Testcontainers Desktop is a free companion app for the open source Testcontainers libraries that enriches the Testcontainers user-experience makes local development and testing with real dependencies even simpler. Read more about Testcontainers Desktop in the documentation.

Try it following the Simple local development with Testcontainers Desktop guide.

Or watch the quick video introduction:

Introducing Testcontainers Desktop

Pinned Loading

  1. testcontainers-java testcontainers-java Public

    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.

    Java 8.3k 1.7k

  2. testcontainers-dotnet testcontainers-dotnet Public

    A library to support tests with throwaway instances of Docker containers for all compatible .NET Standard versions.

    C# 4.1k 331

  3. testcontainers-go testcontainers-go Public

    Testcontainers for Go is a Go package that makes it simple to create and clean up container-based dependencies for automated integration/smoke tests. The clean, easy-to-use API enables developers t…

    Go 4.3k 570

  4. testcontainers-node testcontainers-node Public

    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.

    TypeScript 2.3k 238

  5. testcontainers-python testcontainers-python Public

    Testcontainers is a Python library that providing a friendly API to run Docker container. It is designed to create runtime environment to use during your automatic tests.

    Python 1.9k 328

  6. testcontainers-rs testcontainers-rs Public

    A library for integration-testing against docker containers from within Rust.

    Rust 914 162

Repositories

Showing 10 of 55 repositories
  • testcontainers-java Public

    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.

    testcontainers/testcontainers-java’s past year of commit activity
    Java 8,311 MIT 1,731 413 (22 issues need help) 101 Updated Sep 2, 2025
  • testcontainers-go Public

    Testcontainers for Go is a Go package that makes it simple to create and clean up container-based dependencies for automated integration/smoke tests. The clean, easy-to-use API enables developers to programmatically define containers that should be run as part of a test and clean up those resources when the test is done.

    testcontainers/testcontainers-go’s past year of commit activity
    Go 4,316 MIT 570 106 (4 issues need help) 51 Updated Sep 2, 2025
  • sshd-docker Public

    Docker image with SSH daemon installed

    testcontainers/sshd-docker’s past year of commit activity
    Dockerfile 14 Apache-2.0 7 0 2 Updated Sep 2, 2025
  • vnc-recorder Public

    Docker image that can be used to create a sidekick container for recording videos of VNC sessions hosted in other containers

    testcontainers/vnc-recorder’s past year of commit activity
    Dockerfile 10 11 1 (1 issue needs help) 4 Updated Sep 2, 2025
  • helloworld Public

    A Docker image to support Testcontainers' self-test suites

    testcontainers/helloworld’s past year of commit activity
    Dockerfile 7 MIT 10 1 4 Updated Sep 1, 2025
  • moby-ryuk Public

    Schedule Moby/Docker containers cleanup after specific delay.

    testcontainers/moby-ryuk’s past year of commit activity
    Go 221 MIT 38 6 5 Updated Sep 1, 2025
  • testcontainers-node Public

    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.

    testcontainers/testcontainers-node’s past year of commit activity
    TypeScript 2,271 MIT 238 22 (4 issues need help) 5 Updated Sep 1, 2025
  • testcontainers-hs Public

    Docker containers for your integration tests! http://hackage.haskell.org/package/testcontainers

    testcontainers/testcontainers-hs’s past year of commit activity
    Haskell 72 MIT 19 7 4 Updated Aug 28, 2025
  • testcontainers-dotnet Public

    A library to support tests with throwaway instances of Docker containers for all compatible .NET Standard versions.

    testcontainers/testcontainers-dotnet’s past year of commit activity
    C# 4,117 MIT 331 45 (3 issues need help) 24 Updated Aug 28, 2025
  • testcontainers-rs-modules-community Public

    Community maintained modules for Testcontainers for Rust

    testcontainers/testcontainers-rs-modules-community’s past year of commit activity
    Rust 146 MIT 66 9 (3 issues need help) 3 Updated Aug 27, 2025