NewHeap.Platform.AspNet.Proxy.Sqlite 1.1.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package NewHeap.Platform.AspNet.Proxy.Sqlite --version 1.1.0
                    


                    

                
NuGet\Install-Package NewHeap.Platform.AspNet.Proxy.Sqlite -Version 1.1.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="NewHeap.Platform.AspNet.Proxy.Sqlite" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="NewHeap.Platform.AspNet.Proxy.Sqlite" Version="1.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="NewHeap.Platform.AspNet.Proxy.Sqlite" />
                    


                            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 NewHeap.Platform.AspNet.Proxy.Sqlite --version 1.1.0
                    


                    

                
#r "nuget: NewHeap.Platform.AspNet.Proxy.Sqlite, 1.1.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 NewHeap.Platform.AspNet.Proxy.Sqlite@1.1.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=NewHeap.Platform.AspNet.Proxy.Sqlite&version=1.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=NewHeap.Platform.AspNet.Proxy.Sqlite&version=1.1.0
                    


                            Install as a Cake Tool

NewHeap ASP.NET Proxy SQLite

Store redirects, rewrites, login activity and API change audits in a local SQLite database. No separate database server is required.

Install the proxy · Configuration · Usage reference

Storage configuration

AddNewHeapProxy creates the database and loads saved rules at startup. Configure Sqlite:DatabasePath and Sqlite:BusyTimeout under NewHeapProxy; see the configuration table for defaults. Restart after changing settings.

Requirement What to do
Location Use writable, persistent local storage outside the webroot. Network and in-memory databases are unsupported.
Relative paths Paths are relative to the application's content root.
Containers Mount persistent local storage for the database directory.
Ownership Run one proxy instance per database file. Stop it before opening an offline store.
Live changes Use the administration panel or configuration service. Direct database edits and multiple writers are unsupported.

Backups and upgrades

  • Back up after a clean shutdown, or use SQLite's backup API while running.
  • Do not copy only the main database while the proxy is running; recent changes may be in the write-ahead log.
  • Back up before upgrading. Database upgrades preserve rules and login activity, but older proxy versions may not reopen the upgraded file.

Startup problems

Schema 4 adds the append-only NhProxyChangeAudit table. API saves insert the authenticated actor, UTC time, engine, revisions and normalized before/after configuration in the same transaction as the snapshot update. An audit insert failure rolls back the save. Activation retry records intent before execution. Read the audit through the authenticated GET /newheap-proxy/api/audit endpoint; records are retained without automatic expiration and survive restarts. Existing configuration and login-audit data are preserved during the upgrade. Older binaries cannot reopen schema 4; restoring a pre-upgrade backup is required for a downgrade.

Problem Action
Database cannot be opened Check the directory, file permissions and available storage.
Another instance owns the database Stop that instance or use a separate database file.
A .lock file remains after shutdown Its presence alone does not mean the database is in use. Never delete it to bypass a running instance.
Invalid or incompatible database Check application diagnostics and restore a compatible backup if needed. Startup fails instead of resetting stored rules.

Seed rules offline

See Seed a redirect before starting the host for an example that retains existing rules and checks save failures.

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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.0 0 9/15/2026
1.0.1 34 9/14/2026
1.0.0 42 9/10/2026