Skip to main content
N
Testcontainers package icon

Testcontainers

v4.1.0

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

HofmeisterAn Testcontainers
automation docker dotnet testcontainers testcontainers-dotnet testing
NuGet Stats Changelog
Total Downloads
107.2M
107,173,938
Published
Dec 9, 2024
Latest stable version

Install

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

Frameworks

net8.0 net9.0 .NETStandard2.0 .NETStandard2.1

Dependencies

Docker.DotNet.Enhanced
net8.0
[3.126.1, )
Docker.DotNet.Enhanced.X509
net8.0
[3.126.1, )
Microsoft.Extensions.Logging.Abstractions
net8.0
[8.0.2, )
SSH.NET
net8.0
[2024.1.0, )
SharpZipLib
net8.0
[1.4.2, )
Docker.DotNet.Enhanced
net9.0
[3.126.1, )
Docker.DotNet.Enhanced.X509
net9.0
[3.126.1, )
Microsoft.Extensions.Logging.Abstractions
net9.0
[8.0.2, )
SSH.NET
net9.0
[2024.1.0, )
SharpZipLib
net9.0
[1.4.2, )
BouncyCastle.Cryptography
.NETStandard2.0
[2.4.0, )
Docker.DotNet.Enhanced
.NETStandard2.0
[3.126.1, )
Docker.DotNet.Enhanced.X509
.NETStandard2.0
[3.126.1, )
Microsoft.Bcl.AsyncInterfaces
.NETStandard2.0
[8.0.0, )
Microsoft.Bcl.HashCode
.NETStandard2.0
[1.1.1, )
Microsoft.Extensions.Logging.Abstractions
.NETStandard2.0
[8.0.2, )
SSH.NET
.NETStandard2.0
[2024.1.0, )
SharpZipLib
.NETStandard2.0
[1.4.2, )
BouncyCastle.Cryptography
.NETStandard2.1
[2.4.0, )
Docker.DotNet.Enhanced
.NETStandard2.1
[3.126.1, )
Docker.DotNet.Enhanced.X509
.NETStandard2.1
[3.126.1, )
Microsoft.Bcl.AsyncInterfaces
.NETStandard2.1
[8.0.0, )
Microsoft.Bcl.HashCode
.NETStandard2.1
[1.1.1, )
Microsoft.Extensions.Logging.Abstractions
.NETStandard2.1
[8.0.2, )
SSH.NET
.NETStandard2.1
[2024.1.0, )
SharpZipLib
.NETStandard2.1
[1.4.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.

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

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

The published metadata declares 26 direct dependency entries across framework groups. Inspect the resolved dependency graph for your target framework.

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