Skip to main content
.NETStandard2.0.NETStandard2.1

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

Published
Jun 20, 2022
4y ago
Total Downloads
122.6M
122,597,442

Install

dotnet add package Testcontainers --version 1.7.0-beta.2530372824
ProductVersions
.NET Standard
netstandard2.0netstandard2.1

Changes from Previous Version

v0.0.2.107v1.7.0-beta.2530372824
Added Frameworks
.NETStandard2.1
Added Dependencies
Docker.DotNet(.NETStandard2.0)
SharpZipLib(.NETStandard2.0)
System.Text.Json(.NETStandard2.0)
Docker.DotNet(.NETStandard2.1)
SharpZipLib(.NETStandard2.1)
System.Text.Json(.NETStandard2.1)
Removed Dependencies
Docker.Dotnet(.NETStandard2.0)
MySql.Data(.NETStandard2.0)
Newtonsoft.Json(.NETStandard2.0)
Npgsql(.NETStandard2.0)
Polly(.NETStandard2.0)
RabbitMQ.Client(.NETStandard2.0)
StackExchange.Redis(.NETStandard2.0)
StyleCop.Analyzers(.NETStandard2.0)

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.