WireMock.Net.Testcontainers
1.23.0
Prefix Reserved
dotnet add package WireMock.Net.Testcontainers --version 1.23.0
NuGet\Install-Package WireMock.Net.Testcontainers -Version 1.23.0
<PackageReference Include="WireMock.Net.Testcontainers" Version="1.23.0" />
<PackageVersion Include="WireMock.Net.Testcontainers" Version="1.23.0" />
<PackageReference Include="WireMock.Net.Testcontainers" />
paket add WireMock.Net.Testcontainers --version 1.23.0
#r "nuget: WireMock.Net.Testcontainers, 1.23.0"
#:package WireMock.Net.Testcontainers@1.23.0
#addin nuget:?package=WireMock.Net.Testcontainers&version=1.23.0
#tool nuget:?package=WireMock.Net.Testcontainers&version=1.23.0
WireMock.Net
Lightweight Http Mocking Server for .NET, inspired by WireMock.org (from the Java landscape).
⭐ Key Features
- HTTP response stubbing, matchable on URL/Path, headers, cookies and body content patterns
- Library can be used in unit tests and integration tests
- Runs as a standalone process, as windows service, as Azure/IIS or as docker
- Configurable via a fluent C# .NET API, JSON files and JSON over HTTP
- Record/playback of stubs (proxying)
- Per-request conditional proxying
- Stateful behaviour simulation
- Response templating / transformation using Handlebars and extensions
- Can be used locally or in CI/CD scenarios
- Can be used for Aspire Distributed Application testing
⭐ Stubbing
A core feature of WireMock.Net is the ability to return predefined HTTP responses for requests matching criteria. See Stubbing.
⭐ Request Matching
WireMock.Net support advanced request-matching logic, see Request Matching.
⭐ Response Templating
The response which is returned WireMock.Net can be changed using templating. This is described here Response Templating.
⭐ Admin API Reference
The WireMock admin API provides functionality to define the mappings via a http interface see Admin API Reference.
⭐ Using
WireMock.Net can be used in several ways:
UnitTesting
You can use your favorite test framework and use WireMock within your tests, see UnitTesting.
Unit/Integration Testing using Testcontainers.DotNet
See WireMock.Net.Testcontainers on how to build a WireMock.Net Docker container which can be used in Unit/Integration testing.
Unit/Integration Testing using an an Aspire Distributed Application
See WireMock.Net.Aspire on how to use WireMock.Net as an Aspire Hosted application to do Unit/Integration testing.
As a dotnet tool
It's simple to install WireMock.Net as (global) dotnet tool, see dotnet tool.
As standalone process / console application
This is quite straight forward to launch a mock server within a console application, see Standalone Process.
As a Windows Service
You can also run WireMock.Net as a Windows Service, follow this Windows Service.
As a Web Job in Azure or application in IIS
See this link WireMock-as-a-(Azure)-Web-App
In a docker container
There is also a Linux and Windows-Nano container available at hub.docker.com. For more details see also Docker.
HTTPS / SSL
More details on using HTTPS (SSL) can be found here HTTPS
📚 Documentation
For more info, see also this documentation page: What is WireMock.Net.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- Testcontainers (>= 4.10.0)
- WireMock.Net.RestClient (>= 1.23.0)
-
.NETStandard 2.1
- Stef.Validation (>= 0.1.1)
- System.Text.RegularExpressions (>= 4.3.1)
- Testcontainers (>= 4.10.0)
- WireMock.Net.RestClient (>= 1.23.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.23.0 | 984 | 1/5/2026 |
| 1.22.0 | 696 | 1/2/2026 |
| 1.21.0 | 1,693 | 12/25/2025 |
| 1.20.0 | 459 | 12/24/2025 |
| 1.19.0 | 6,104 | 12/12/2025 |
| 1.18.0 | 2,643 | 12/9/2025 |
| 1.17.0 | 2,449 | 12/7/2025 |
| 1.16.0 | 7,940 | 11/18/2025 |
| 1.15.0 | 30,359 | 10/22/2025 |
| 1.14.0 | 13,549 | 10/6/2025 |
| 1.14.0-preview-01 | 162 | 10/3/2025 |
| 1.13.0 | 5,507 | 9/28/2025 |
| 1.12.0 | 37,683 | 8/30/2025 |
| 1.11.2 | 1,324 | 8/27/2025 |
| 1.11.1 | 451 | 8/27/2025 |
| 1.11.0 | 4,341 | 8/26/2025 |
| 1.10.1 | 1,161 | 8/22/2025 |
| 1.10.0 | 5,565 | 8/18/2025 |
| 1.9.1 | 649 | 8/17/2025 |
| 1.9.0 | 8,244 | 8/10/2025 |
| 1.8.18 | 2,497 | 8/4/2025 |
| 1.8.17 | 17,119 | 7/23/2025 |
| 1.8.16 | 3,604 | 7/19/2025 |
| 1.8.15 | 614 | 7/18/2025 |
| 1.8.14 | 3,321 | 7/13/2025 |
| 1.8.13 | 61,174 | 6/23/2025 |
| 1.8.13-preview-02 | 176 | 6/21/2025 |
| 1.8.13-preview-01 | 197 | 6/20/2025 |
| 1.8.12 | 13,836 | 6/15/2025 |
| 1.8.11 | 4,673 | 6/11/2025 |
| 1.8.10 | 4,816 | 6/10/2025 |
| 1.8.9 | 19,830 | 5/28/2025 |
| 1.8.8 | 1,554 | 5/24/2025 |
| 1.8.7 | 652 | 5/22/2025 |
| 1.8.6 | 7,805 | 5/15/2025 |
| 1.8.5 | 3,373 | 5/14/2025 |
| 1.8.4 | 2,840 | 5/8/2025 |
| 1.8.3 | 5,554 | 5/6/2025 |
| 1.8.2 | 5,295 | 5/5/2025 |
| 1.8.1 | 576 | 5/2/2025 |
| 1.8.0 | 3,671 | 4/29/2025 |
| 1.8.0-prview-01 | 619 | 3/4/2025 |
| 1.7.5-preview-02 | 234 | 4/3/2025 |
| 1.7.5-preview-01 | 239 | 4/2/2025 |
| 1.7.4 | 92,865 | 2/27/2025 |
| 1.7.3 | 1,278 | 2/24/2025 |
| 1.7.2 | 22,095 | 2/12/2025 |
| 1.7.2-preview-01 | 165 | 2/7/2025 |
| 1.7.1 | 16,469 | 1/27/2025 |
| 1.7.0 | 2,472 | 1/22/2025 |
| 1.6.12 | 2,358 | 1/21/2025 |
| 1.6.11 | 10,760 | 1/2/2025 |
| 1.6.10 | 7,345 | 12/15/2024 |
| 1.6.9 | 9,400 | 12/6/2024 |
| 1.6.8 | 18,307 | 11/24/2024 |
| 1.6.7 | 57,222 | 10/17/2024 |
| 1.6.7-preview-02 | 228 | 10/6/2024 |
| 1.6.7-preview-01 | 162 | 10/2/2024 |
| 1.6.6 | 19,652 | 10/1/2024 |
| 1.6.5 | 621 | 9/28/2024 |
| 1.6.4 | 7,240 | 9/25/2024 |
| 1.6.3 | 19,873 | 9/7/2024 |
| 1.6.2 | 20,358 | 9/4/2024 |
| 1.6.1 | 3,562 | 8/22/2024 |
| 1.6.0 | 8,221 | 8/16/2024 |
| 1.5.62 | 11,718 | 7/27/2024 |
| 1.5.61 | 209 | 7/27/2024 |
| 1.5.60 | 35,636 | 7/9/2024 |
| 1.5.59 | 2,901 | 6/26/2024 |
| 1.5.58 | 5,355 | 6/8/2024 |
| 1.5.57 | 3,780 | 6/4/2024 |
| 1.5.56 | 332 | 6/3/2024 |
| 1.5.55 | 29,396 | 5/22/2024 |
| 1.5.54 | 1,613 | 5/18/2024 |
| 1.5.53 | 3,295 | 5/8/2024 |
| 1.5.52 | 29,292 | 4/6/2024 |
| 1.5.51 | 3,779 | 3/20/2024 |
| 1.5.50 | 241 | 3/20/2024 |
| 1.5.49 | 5,180 | 3/6/2024 |
| 1.5.48 | 3,381 | 2/17/2024 |
| 1.5.47 | 13,808 | 1/25/2024 |
| 1.5.46 | 17,854 | 12/23/2023 |
| 1.5.45 | 695 | 12/21/2023 |
| 1.5.44 | 837 | 12/14/2023 |
| 1.5.43 | 612 | 12/11/2023 |
| 1.5.42 | 321 | 12/9/2023 |
| 1.5.41 | 492 | 12/4/2023 |
| 1.5.40 | 7,901 | 11/7/2023 |
| 1.5.39 | 2,724 | 10/9/2023 |
| 1.5.38 | 248 | 10/9/2023 |
| 1.5.37 | 2,918 | 9/27/2023 |
| 1.5.36 | 756 | 9/21/2023 |
| 1.5.35 | 17,404 | 8/19/2023 |
| 1.5.34 | 5,520 | 8/4/2023 |
| 1.5.32 | 18,288 | 7/15/2023 |
| 1.5.31 | 393 | 7/8/2023 |
| 1.5.30 | 323 | 6/28/2023 |
| 1.5.29 | 361 | 6/22/2023 |
| 1.5.28 | 1,817 | 6/11/2023 |
| 1.0.0 | 723 | 7/22/2024 |
| 0.0.1-preview-01 | 271 | 6/7/2023 |
# 1.23.0 (05 January 2026)
- #1414 Pass the parameter matchOperator in Request.WithPath to its inner calls [bug]
- #1416 Fix: Pass AllowedHandlebarsHelpers configuration to Handlebars.Net.Helpers library
- #1413 Parameter `matchOperator` is not respected in the method Request.WithPath [bug]
- #1415 HandlebarsSettings AllowedHandlebarsHelpers Configuration Not Applied [bug]
The full release notes can be found here: https://github.com/wiremock/WireMock.Net/blob/master/CHANGELOG.md