Setup

Install ArgusLogs

Add PackageReference entries for ArgusLogs, ArgusLogs.DataAnnotation, and optionally ArgusLogs.TieredStorage + ArgusLogs.UI for the embedded /argus-logs viewer.

Guide 2 of 11 Install ArgusLogs

Generate a license key

Quick-start licenses for local development and production. No account, domain, or IP registration — valid until 1 January 2028 on any host. Online verification runs inside ArgusLogs.core automatically.

  • No login
  • Any host
  • Until Jan 2028
  • Online verify

dotnet CLI

From your project directory, add both packages from nuget.org. Current versions are pre-release (1.0.11-alpha.2608292142) — not a generally available stable 1.0. Use the same version for every ArgusLogs.* package in the solution.

Shell
dotnet add package ArgusLogs --version 1.0.11-alpha.2608292142
dotnet add package ArgusLogs.DataAnnotation --version 1.0.11-alpha.2608292142

PackageReference

Alternatively, add these PackageReference entries to your .csproj file inside an ItemGroup:

XML
<PackageReference Include="ArgusLogs" Version="1.0.11-alpha.2608292142" />
<PackageReference Include="ArgusLogs.DataAnnotation" Version="1.0.11-alpha.2608292142" />

ArgusLogs.UI (optional)

For the embedded diagnostics dashboard at /argus-logs, also install ArgusLogs.TieredStorage and ArgusLogs.UI. Keep the same version as ArgusLogs core.

Shell
dotnet add package ArgusLogs.TieredStorage --version 1.0.11-alpha.2608292142
dotnet add package ArgusLogs.UI --version 1.0.11-alpha.2608292142

PackageReference — UI stack

Add these alongside the core packages when enabling ArgusLogs.UI:

XML
<PackageReference Include="ArgusLogs.TieredStorage" Version="1.0.11-alpha.2608292142" />
<PackageReference Include="ArgusLogs.UI" Version="1.0.11-alpha.2608292142" />

License keys (quick start)

After installing NuGet packages, add an ArgusLogs license key to appsettings.json (ArgusLogsKey). Use the generator panel above or call the installation quick-start API below — no account, login, domain, or IP registration required. Keys are valid until 1 January 2028, work on any host. Online verification runs inside ArgusLogs.core — only ArgusLogsKey is required in your app. This path is separate from the Subscription Manager project license flow (POST /api/v1/projects/{projectId}/licenses/generate).

Production license — API

Creates a Production key without login or domain/IP bindings — valid until 2028-01-01 on any system. Online verification is handled by ArgusLogs.core. Use environment Development for a key with all features. For domain-bound production keys with lease enforcement, use the Subscription Manager portal after registering project parameters.

Shell
curl -X POST 'https://api.arguslogs.com/api/v1/installation-licenses/generate' \
  -H 'Content-Type: application/json' \
  -d '{"environment":"Production","projectName":"YOUR_PROJECT_NAME"}'

Wire the license in appsettings.json

Paste the licenseKey from the API response into your ASP.NET Core configuration, then pass it to AddArgus():

JSON + C#
{
  "ArgusLogsKey": "PASTE_LICENSE_KEY_FROM_API_RESPONSE"
}

// Program.cs
builder.Services.AddArgus(options =>
{
    options.SetLicense(builder.Configuration["ArgusLogsKey"] ?? "");
});

Related resources