Dotnet ASP Web API

A self-hosted ASP.NET Core web API template that serves versioned RESTful endpoints on a Linux host.

  • Development
  • Other
  • Tools & Utilities
A self-hosted ASP.NET Core web API template that serves versioned RESTful endpoints on a Linux host. A Proxmox community script is available to deploy it on Proxmox hosts, adding an API versioning package and running the service with dotnet run. A good fit for homelab developers who want a lightweight, self-hosted REST backend without an application server such as IIS.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

73/100 Good

Maintained
100last commit 21 days ago
Popular
8213,152 GitHub stars
Easy to install
251 install platform, install notes
Light to run
502 GB minimum RAM

Availability: platform listings confirmed today

GitHub stars
13,152
Open issues
496
Last commit
2026-10-31
Latest release
220491
License
CC-BY-4.0
Activity
rising

Checked 21 days ago - source: GitHub (dotnet/AspNetCore.Docs)

Resources & Compatibility

Minimum requirements: 2 GB RAM.

Checked 40 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the versioning package In the project folder, run `dotnet add package Asp.Versioning.Http` to add the versioning library the API needs. Without this NuGet package (a .NET library package), the versioned API code won't work. source
  • Start the API with dotnet run From the project folder, run `dotnet run` to start the web API locally. If you skip this step, the app isn't running and nothing is available to accept API calls. source
  • Version status names must be simple A version status is a label such as beta, and it must start with a letter, use only letters, digits, and periods, and not end with a period. Invalid labels like preview-1 can make the app crash with a runtime error. source
  • Install the .NET runtime Before the API can run, install the .NET runtime on the Linux host using Microsoft's Linux installation guide (documentation link); the versioning package and dotnet run steps assume the runtime is present. source

Fetched 4 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can I self-host an ASP.NET Core Web API without IIS?

Yes. ASP.NET Core applications can be self-hosted without IIS.

Can I use SQLite instead of PostgreSQL for a self-hosted .NET API?

One suggested alternative is switching from PostgreSQL to SQLite and installing it alongside whatever web server you use.

Answers sourced from stackoverflow.com, www.reddit.com

Community

Collected 48 days ago - public community threads