Skip to main content
.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.

Published
Nov 25, 2022
3y ago
Total Downloads
122.6M
122,597,442

Install

dotnet add package Testcontainers --version 2.3.0-beta.3547636764
ProductVersions
.NET Standard
netstandard2.0netstandard2.1

README

Testcontainers

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 - 2022 Andre Hofmeister and other authors.

See contributors for all contributors.


Join our Slack workspace | Testcontainers OSS | Testcontainers Cloud

Changes from Previous Version

v2.2.0v2.3.0-beta.3547636764
Removed Dependencies

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 2 target frameworks; confirm the exact target used by your application.
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.