A Clean Architecture solution template for ASP.NET Core with separate Core, Use Cases, Infrastructure and Web projects.
dotnet/yarp
A .NET toolkit for building high-performance HTTP reverse proxy servers that can be customized for specific deployment needs.
- Stars
- 9,636
- Forks
- 932
- Open issues
- 199
- Last commit
- 6 days ago
What is it?
YARP (Yet Another Reverse Proxy) is a toolkit for building reverse proxy servers in .NET on top of the ASP.NET Core infrastructure. It is distributed as a library and project template, so developers assemble their own proxy rather than configuring a fixed binary.
The main design goal is customizability. Its request pipeline and modules can be extended, and routes and clusters can be set through configuration files or through an in-process configuration API. This suits teams that manage proxy configuration from their own backend systems instead of static files.
The project started as a collaboration among internal Microsoft teams that were building reverse proxies for their services. It is developed in the open under the dotnet organization, with getting-started documentation on Microsoft Learn.
Key features
- 01Built on ASP.NET Core and .NET infrastructure in C#.
- 02Extensible request pipeline with customizable modules.
- 03Supports configuration files and a programmatic in-process configuration API.
- 04Distributed as a library and project template for building custom proxy servers.
Use cases
- Building a custom reverse proxy or API gateway for .NET services.
- Routing traffic to backend services with configuration managed by an internal system.
- Adding custom logic such as authentication or request transformation to proxied traffic.
Quick start
- 1
Read the official getting started docs
- 2
Build the repo on Linux or macOS (the script downloads the .NET SDK)
build.sh
Things to know
- It ships as a library and project template, so customizing it requires .NET development knowledge.
Topics
FAQ
- What is yarp?
- A .NET toolkit for building high-performance HTTP reverse proxy servers that can be customized for specific deployment needs. YARP (Yet Another Reverse Proxy) is a toolkit for building reverse proxy servers in .NET on top of the ASP.NET Core infrastructure. It is distributed as a library and project template, so developers assemble their own proxy rather than configuring a fixed binary.
- Is yarp free to use? What license does it have?
- yarp is open source under the MIT license. Check the license terms before using it in commercial products.
- Is yarp still maintained?
- Actively maintained. The last commit to yarp was on Oct 19, 2026.
- What can I use yarp for?
- Building a custom reverse proxy or API gateway for .NET services. Routing traffic to backend services with configuration managed by an internal system. Adding custom logic such as authentication or request transformation to proxied traffic.
- How do I install yarp?
- Read the official getting started docs Build the repo on Linux or macOS (the script downloads the .NET SDK): build.sh
- Where can I get yarp?
- The source code and installation instructions are on GitHub: https://github.com/dotnet/yarp
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A self-hosted digital photo frame app that displays photos from an Immich server as a slideshow.
A self-hosted media server for movies, TV series and music, built for a small circle of family and friends.
A cloud native HTTP reverse proxy and load balancer that auto-configures routes from Docker, Kubernetes, Consul and other orchestrators.
Open-source, self-hostable SASE platform built on WireGuard that combines zero-trust VPN, reverse proxy, privileged access and an AI gateway.
A high-performance web server, reverse proxy, load balancer, API gateway and content cache written in C.