Runlight 0.3.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Runlight --version 0.3.0
                    
NuGet\Install-Package Runlight -Version 0.3.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Runlight" Version="0.3.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Runlight" Version="0.3.0" />
                    
Directory.Packages.props
<PackageReference Include="Runlight" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Runlight --version 0.3.0
                    
#r "nuget: Runlight, 0.3.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Runlight@0.3.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Runlight&version=0.3.0
                    
Install as a Cake Addin
#tool nuget:?package=Runlight&version=0.3.0
                    
Install as a Cake Tool

Runlight for .NET

Runlight is privacy friendly web analytics that runs inside your own ASP.NET Core app. It counts visitors without cookies and without storing anyone’s IP address. The numbers stay in your database, and the dashboard is served from your domain at /runlight.

These packages are the .NET version of Runlight. They need .NET 10 or later, and the runlight tool also runs Runlight on a domain of its own. They answer every request the way the TypeScript library does and use the same tables, so either one can read the other’s database.

Package What it is
Runlight The library, with no dependencies of its own.
Runlight.AspNetCore MapRunlight() and UseRunlight() for ASP.NET Core.
Runlight.Server The runlight tool, which runs the standalone server.

Get started

Add the ASP.NET Core package and the driver for your database.

dotnet add package Runlight.AspNetCore
dotnet add package Microsoft.Data.Sqlite

Create one instance for your app, and map its routes.

using Microsoft.Data.Sqlite;
using Runlight;
using Runlight.Store;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSingleton(new Runlight.Runlight(new RunlightOptions
{
    Store = Stores.Sqlite(SqliteFactory.Instance, "data/runlight.db"),
    Site = new SiteOptions { Name = "example.com", Hostnames = ["example.com"], Timezone = "Europe/London" },
}));

var app = builder.Build();
app.MapRunlight();
app.Run();

Add the script to every page, just before </head>.

<script defer src="/runlight/s.js"></script>

Set RUNLIGHT_TOKEN to a long random string, then open /runlight/?token= followed by that string to sign in.

To run Runlight on a domain of its own, install the tool and start it in an empty folder.

dotnet tool install --global Runlight.Server
runlight serve

The .NET guide has the Postgres, MySQL, and MariaDB stores, the scheduled check, sign-in accounts, and the standalone server’s settings.

License

Runlight is MIT licensed.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net10.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Runlight:

Package Downloads
Runlight.AspNetCore

Runlight on ASP.NET Core: MapRunlight serves the dashboard, the tracker, and short links from your app.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.5.0 50 11/15/2026
0.4.3 76 11/10/2026
0.4.2 64 11/10/2026
0.4.1 86 11/10/2026
0.4.0 102 11/9/2026
0.3.3 102 11/6/2026
0.3.2 125 10/27/2026
0.3.1 110 10/26/2026
0.3.0 115 10/24/2026
0.2.0 110 10/18/2026
0.1.8 118 10/17/2026
0.1.7 111 10/15/2026
0.1.6 111 10/14/2026
0.1.5 111 10/14/2026
0.1.4 109 10/14/2026
0.1.3 112 10/12/2026
0.1.2 101 10/12/2026
0.1.1 107 10/11/2026
0.1.0 114 10/10/2026