Skip to main content
N
3.7.03.8.0
Testcontainers package icon

Testcontainers

v3.8.0-beta.8238206979Pre-release
net6.0net8.0.NETStandard2.0.NETStandard2.1

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

HofmeisterAnTestcontainers
NuGetWebsiteLicenseCompare
Published
Mar 11, 2024
2y ago
Total Downloads
122.6M
122,597,442

Install

dotnet add package Testcontainers --version 3.8.0-beta.8238206979
Download NuGet FileBrowse File Contents
ProductVersions
.NET
net6.0net8.0
.NET Standard
netstandard2.0netstandard2.1

README

Testcontainers

Open in GitHub Codespaces

NuGet CI/CD Alert Status Coverage

Testcontainers for .NET is a library to support tests with throwaway instances of Docker containers for all compatible .NET Standard versions. The library is built on top of the .NET Docker remote API and provides a lightweight implementation to support your test environment in all circumstances.

Testcontainers Banner

Read the documentation here

License

See LICENSE.

Copyright

Copyright (c) 2019 - 2024 Andre Hofmeister and other authors.

See contributors for all contributors.

Join our Slack workspace | Testcontainers OSS | Testcontainers Cloud

Changes from Previous Version

v3.7.0v3.8.0-beta.8238206979
Added Frameworks
net6.0net8.0
Added Dependencies
Docker.DotNet(net6.0)
Docker.DotNet.X509(net6.0)
Microsoft.Extensions.Logging.Abstractions(net6.0)
SSH.NET(net6.0)
SharpZipLib(net6.0)
Docker.DotNet(net8.0)
Docker.DotNet.X509(net8.0)
Microsoft.Extensions.Logging.Abstractions(net8.0)
SSH.NET(net8.0)
SharpZipLib(net8.0)
Microsoft.Bcl.HashCode(.NETStandard2.0)
Microsoft.Bcl.HashCode(.NETStandard2.1)

Adoption Assessment

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

Integration Testing Guide
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 4 target frameworks; confirm the exact target used by your application.The published metadata declares 28 direct dependency entries across framework groups. Inspect the resolved dependency graph for your target framework.
Editorial Note: 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.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.

Integration Testing GuideUnit Testing GuideAudit NuGet dependencies in a .NET projectReview NuGet licenses before shipping