NuGet

NORA acts as a caching proxy for the NuGet v3 API. Package files (.nupkg, .nuspec) are immutably cached; service index and metadata use TTL-based refresh. This is a proxy-only registry — pushing packages is not supported.

Client Configuration

Add NORA as a NuGet source:

dotnet nuget add source http://nora.example.com:4000/nuget/v3/index.json -n nora

Or in nuget.config:

<configuration>
  <packageSources>
    <add key="nora" value="http://nora.example.com:4000/nuget/v3/index.json" />
  </packageSources>
</configuration>

Then restore packages as usual:

dotnet restore

Upstream Proxy

config.toml:

[nuget]
enabled = true
proxy = "https://api.nuget.org"
proxy_timeout = 30
metadata_ttl = 300  # seconds

Environment variables:

Variable	Description	Default
NORA_NUGET_ENABLED	Enable NuGet proxy	false
NORA_NUGET_PROXY	Upstream NuGet API URL	https://api.nuget.org
NORA_NUGET_PROXY_AUTH	Upstream auth (user:pass)	—
NORA_NUGET_PROXY_TIMEOUT	Upstream timeout in seconds	30
NORA_NUGET_METADATA_TTL	Metadata cache TTL in seconds	300

Features

Feature	Status	Notes
Service index (/v3/index.json)	Full	@id URLs rewritten to NORA
Registration index	Full	TTL-cached
Version list (flat container)	Full	TTL-cached
.nupkg download	Full	Immutable cache
.nuspec download	Full	Immutable cache
Package push	—	Proxy-only (read)
Search	—	Not implemented

Known Limitations

• Proxy-only: dotnet nuget push is not supported. NORA caches packages downloaded from the upstream registry.
• Search endpoint is not implemented.
• Disabled by default. Set NORA_NUGET_ENABLED=true to activate.