docs/roadmap.md
| Version | Release Date | Latest Patch Version | End of Support |
|---|---|---|---|
| YARP 2.3 | February 27, 2025 | 2.3.0 |
| Version | Released date | Final Patch Version | End of support |
|---|---|---|---|
| YARP 2.2 | September 3, 2024 | 2.2.0 | August 27, 2025 |
| YARP 2.1 | November 17, 2023 | 2.1.0 | March 3, 2025 |
| YARP 2.0 | February 14, 2023 | 2.0.1 | May 17, 2024 |
| YARP 1.1 | May 2, 2022 | 1.1.2 | August 14, 2023 |
| YARP 1.0 | November 9, 2021 | 1.0.1 | November 2, 2022 |
YARP support is provided by the product team - the engineers working on YARP - which is a combination of members from ASP.NET and the .NET library teams. We do not provide 24/7 support or 'carry pagers', but we generally have good coverage. Bugs should be reported in GitHub using the issue templates, and will typically be responded to within 24hrs. If you find a security issue we ask you to report it via the Microsoft Security Response Center (MSRC).
The support period for YARP releases is as follows:
| Release | Issue Type | Support period |
|---|---|---|
| Major or minor version | Security Bugs, Major behavior defects | Until next GA + 6 Months |
| Patch version | Minor behavior defects | Until next GA |
| Preview | Security Bugs, Major behavior defects | Until next preview |
| All other | None - may be addressed by next preview |
For example, if 2 months after 1.3 (making up a number) is released, a security issue is found, then we will patch:
This support schedule is designed to provide a reasonable time period for customers to be able to update to new releases.
YARP is an open source project, so any customers that need fixes faster, or for older releases, are able to build their own copy of YARP. The build environment for YARP is included in the repo and maintained in sync with the source. Each release (GA and Preview) of YARP is tagged, which means that if you need to patch a specific release you can sync to the tag and build. For example you can rebuild v1.0.0 with:
git clone -b v1.0.0 https://github.com/dotnet/yarp.git yarp1_0_0
cd yarp1_0_0
restore.cmd
<make your changes>
build.cmd -c release
This will produce the Yarp.ReverseProxy.dll into artifacts/bin/Yarp.ReverseProxy/Release/net6.0, and peer folder(s) for .NET 5 & Core 3.1. If you need to build a nuget package, that can be done with:
pack.cmd -c release
The nuget package will be output to artifacts/packages/release/Shipping.