docker/docs
1
0
Fork 0
mirror of https://github.com/docker/docs.git synced 2026-10-23 18:09:02 +03:00
Code Activity
Files
bot/sync-cli-docs
docs/content/manuals/testcontainers.md
David Karlsson ee71c80562 chore: migrate icons from Material Symbols to Heroicons 
Replaces @material-symbols/svg-400 (5.5 MB) with heroicons (488 KB) — an
11x reduction in icon asset size. Heroicons uses a single consistent
distribution format (24px solid SVGs, fill="currentColor") eliminating
the need for the separate utils/svg.html partial, the icon-svg-stroke CSS
utility, and the dual-path resolution logic in icon.html.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-05-18 12:05:54 +02:00

4.9 KiB
Raw Permalink Blame History

title, weight, description, keywords, params, intro, quickstart
title weight description keywords params intro quickstart
Testcontainers 40 Learn how to use Testcontainers to run containers programmatically in your preferred programming language. docker APIs, docker, testcontainers documentation, testcontainers, testcontainers oss, testcontainers oss documentation, docker compose, docker-compose, java, golang, go
sidebar
group
Open source
title description icon link
What is Testcontainers? Learn about what Testcontainers does and its key benefits magnifying-glass https://testcontainers.com/getting-started/#what-is-testcontainers
title description icon link
The Testcontainers workflow Understand the Testcontainers workflow magnifying-glass-plus https://testcontainers.com/getting-started/#testcontainers-workflow
title description icon link
Testcontainers for Go A Go package that makes it simple to create and clean up container-based dependencies for automated integration/smoke tests. /icons/go.svg https://golang.testcontainers.org/quickstart/
title description icon link
Testcontainers for Java A Java library that supports JUnit tests, providing lightweight, throwaway instances of anything that can run in a Docker container. /icons/java.svg https://java.testcontainers.org/

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.

{{< grid items=intro >}}

Quickstart

Supported languages

Testcontainers provide support for the most popular languages, and Docker sponsors the development of the following Testcontainers implementations:

The rest are community-driven and maintained by independent contributors.

Prerequisites

Testcontainers requires a Docker-API compatible container runtime. During development, Testcontainers is actively tested against recent versions of Docker on Linux, as well as against Docker Desktop on Mac and Windows. These Docker environments are automatically detected and used by Testcontainers without any additional configuration being necessary.

It is possible to configure Testcontainers to work for other Docker setups, such as a remote Docker host or Docker alternatives. However, these are not actively tested in the main development workflow, so not all Testcontainers features might be available and additional manual configuration might be necessary.

If you have further questions about configuration details for your setup or whether it supports running Testcontainers-based tests, contact the Testcontainers team and other users from the Testcontainers community on Slack.

{{< grid items=quickstart >}}

Guides

Explore hands-on Testcontainers guides to learn how to use Testcontainers with different languages and popular frameworks:

View Git Blame Copy Permalink