Skip to main content
N
Testcontainers package icon

Testcontainers

v2.1.0-beta.2698157448

A lightweight library to run tests with throwaway instances of Docker containers.

HofmeisterAn Testcontainers
.NET Docker Container Test
NuGet Stats Changelog
Total Downloads
107.2M
107,173,938
Published
Jul 19, 2022
Latest stable version

Install

.NET CLI
dotnet add package Testcontainers --version 2.1.0-beta.2698157448
Package Manager Console
Install-Package Testcontainers -Version 2.1.0-beta.2698157448
PackageReference
<PackageReference Include="Testcontainers" Version="2.1.0-beta.2698157448" />

Frameworks

.NETStandard2.0 .NETStandard2.1

Dependencies

Docker.DotNet
.NETStandard2.0
[3.125.10, )
Microsoft.Bcl.AsyncInterfaces
.NETStandard2.0
[1.1.1, )
Microsoft.Extensions.Logging.Abstractions
.NETStandard2.0
[3.1.26, )
SharpZipLib
.NETStandard2.0
[1.3.3, )
System.Text.Json
.NETStandard2.0
[4.7.2, )
Docker.DotNet
.NETStandard2.1
[3.125.10, )
Microsoft.Bcl.AsyncInterfaces
.NETStandard2.1
[1.1.1, )
Microsoft.Extensions.Logging.Abstractions
.NETStandard2.1
[3.1.26, )
SharpZipLib
.NETStandard2.1
[1.3.3, )
System.Text.Json
.NETStandard2.1
[4.7.2, )

Adoption guide

Teams that need production-like dependency behavior in CI, including version pinning and reproducible startup contracts.

Integration Testing guide
Why it appears in the guide: Provision disposable Docker-based dependencies (databases, brokers, caches) directly from tests. Trade-off: Container startup overhead and host prerequisites require thoughtful fixture reuse and pipeline tuning.

This version is marked prerelease. Validate its API and upgrade path before production use.

No SPDX license expression is published. Review the license text and your organisation's policy before redistribution.

Compatibility metadata lists 2 target frameworks; confirm the exact target used by your application.

How to read this guidance

Sources: published NuGet v3 registry metadata and explicit NuBrowse editorial guides. Refresh: package metadata is refreshed from NuGet when the page loads. Limit: this is not a security, legal or compatibility guarantee; validate the selected version in your project.

Useful next steps

Move from package metadata to a concrete selection or review workflow.

Integration Testing package guideUnit Testing package guide Audit NuGet dependencies in a .NET projectReview NuGet licenses before shipping