NetlyDB stores your documents and files, answers LINQ queries, searches by keyword or meaning, and can give AI agents governed access to your data. It runs in your process: no database server to install, secure or keep running.
// 1. Add the package
$ dotnet add package NetlyDB.SDK
// 2. Register the database and a collection
builder.Services
.AddNetlyDB()
.AddNetlyDBCollection<Order>();
// 3. Query the collection with LINQ
var page = await orders.Query()
.Where(x => x.Country == "BE")
.OrderByDescending(x => x.Total)
.Take(25)
.ToListAsync();NetlyDB.SDKA client-server database is a separate process you install, patch, secure and keep running, and your application talks to it over the network. NetlyDB is a library: the engine runs in your application's process and your code calls it directly.
Something extra to install, secure, monitor and keep running. Every read and write crosses the network.
Data in memory, every change logged to local disk. Optional modules open the engine to a browser, other applications, AI agents or other nodes. Try the switches.
Optional modules
Embedded database only.
NetlyDB is for applications that own their data and run wherever you deploy them: on a server, on a customer's site, or on a machine that is sometimes offline. Records, files and search stay together, inside the app.
Internal and line-of-business apps that own their records, without a database team behind them.
Software that keeps working when the link to central systems does not.
Blazor WebAssembly apps that keep their data in the browser and keep working without a connection (in development).
Documents, photos and video managed alongside the records they belong to.
Search by meaning over your own data, and give AI assistants governed, read-only access.
Several application instances, each holding a full copy of the data.
Orders, customers, products and settings, stored as your code shapes them and returned typed.
Files next to the records they belong to, in virtual folders and with tags, without a separate file store.
Find content by the words it contains, or by what it means, using embeddings from the model you choose.
One package gives you storage, files, search and AI access. Your own C# types, dependency injection and LINQ. No infrastructure to stand up before the first line of business logic.
One package, one line of setup, no infrastructure. Your first collection is a C# class.
Your own types, dependency injection and LINQ. Queries are checked by the compiler.
Records, documents and media live together. No separate file store to wire up and back up.
Files, search, a REST API, AI access and replication are part of the same product. Switch them on when you need them.
A write is confirmed only once it is safely logged. Recovery is deterministic, and it never guesses.
Health checks, stable error codes and recovery reports show what is happening, without putting your data in logs.
Runs wherever your application runs. Licenses are verified offline, with no license server and no call home.
The database lives inside the application, so the application keeps working with all its data when the connection does not.
Your data, searchable by meaning and reachable by AI agents through read-only tools, under your control.
Every step is a registration on the same service collection. Your code keeps using the same collections while the database gains a console, APIs, AI access and replication.
A fully working database for documents, files, queries and search inside your app.
AddNetlyDB()
A browser console for health, diagnostics, snapshots, queries and indexes, hosted by your app.
AddNetlyDBManagementUI()
Let other applications and AI agents reach your data through a REST API and an MCP server.
AddNetlyDBAPI()
AddNetlyDBMCP()
Run several nodes that each hold a full copy of the data and replicate peer-to-peer.
JoinCluster(seedNodes)
The same engine, compiled to WebAssembly, will run inside a Blazor WebAssembly application. Your server delivers the app once; from then on the data lives on the visitor's device, and every read and write happens there, connection or not.
Your web server serves the application like any other site. NetlyDB is part of what the browser downloads.
The engine runs in a worker, off the UI thread, and stores its log and snapshots in the browser's private file system.
A browser console hosted by your own application, reading the engine in-process. Query with plans, browse documents and files, manage indexes and snapshots, and watch health and metrics. Sign-in required, local access by default.
Browse documents and files, right where they live.
NetlyDB doesn't run models. It keeps the data AI features depend on next to your application data, makes it searchable by meaning, and gives agents a governed, read-only way to reach it.
A query like "something warm for winter hikes" finds the insulated trekking jacket, even though the product text never says "warm" or "winter". Store the embeddings from the model you use, and NetlyDB does the nearest-neighbour search.
An MCP server gives assistants read-only tools over the collections you choose. An operator can ask for "customers above the age of 60, located in Belgium" and the agent builds a structured query that the server validates against your fields before it runs. The server never interprets free text as a query.
A database earns trust by what it does when things go wrong. NetlyDB states its guarantees narrowly, and its limits just as plainly.
A write is confirmed only once it is committed to a checksummed write-ahead log. A crash does not lose it.
Write-ahead log, group commitAn uncertain write is reported as uncertain, never as failed, and can be looked up later by its id.
Resolvable mutation outcomesStartup recovers the same way every time, or stops and explains why in a report.
Snapshot generations, recovery reportsOnly one process writes to a store, and only in engine states that allow it.
Store ownership, admission controlAn index that is not ready is never used. The query scans instead: slower, never wrong.
Versioned indexes, scan fallbackDiagnostic output never contains document values, credentials or key material, and never blocks a write.
Diagnostic codes, audit trailReal code against the published NetlyDB.SDK API. Every sample can be pasted into an application.
Register NetlyDB and a typed collection in any .NET 10 host. Read more
var builder = Host.CreateApplicationBuilder(args); // or WebApplication.CreateBuilder(args)
builder.Services
.AddNetlyDB(options => options.StorageRoot = "netlydb-data")
.AddNetlyDBCollection<Order>();
using var host = builder.Build();
await host.StartAsync();
var orders = host.Services.GetRequiredService<INetlyDBCollection<Order>>();Typed and dynamic document collections, opened through dependency injection or the document store.
Query 50,000 generated demo orders with a real, embedded NetlyDB instance running inside this website. Queries are read-only.
Reported by NetlyDB for this query’s execution, excluding parsing. Measured on a shared web server; not a benchmark.
// orders: IDocumentCollection<Order>, registered by AddNetlyDBCollection<Order>()
var result = await orders.WhereAsync("Country == \"BE\"");
IReadOnlyList<Order> matches = result.UnwrappedDocuments;
TimeSpan queryTime = result.Duration; // execution time reported by NetlyDB[
{
"Reference": "ORD-010237",
"CustomerName": "Summit Pulse Systems",
"Country": "BE",
"Status": "Pending",
"Total": 19086.48,
"CreatedAt": "2026-12-31T16:17:08Z",
"Priority": "High",
"LineCount": 17
},
{
"Reference": "ORD-015800",
"CustomerName": "Nova Stone Supplies",
"Country": "BE",
"Status": "Open",
"Total": 13352.66,
"CreatedAt": "2026-12-30T23:11:56Z",
"Priority": "Low",
"LineCount": 22
},
{
"Reference": "ORD-017089",
"CustomerName": "Global Stone Industries",
"Country": "BE",
"Status": "Pending",
"Total": 7604.92,
"CreatedAt": "2026-12-30T03:32:10Z",
"Priority": "Medium",
"LineCount": 19
},
{
"Reference": "ORD-002001",
"CustomerName": "North Forest Retail",
"Country": "BE",
"Status": "Pending",
"Total": 17312.28,
"CreatedAt": "2026-12-30T01:07:17Z",
"Priority": "Low",
"LineCount": 5
},
{
"Reference": "ORD-014100",
"CustomerName": "Grand Grid Industries",
"Country": "BE",
"Status": "Closed",
"Total": 34650.87,
"CreatedAt": "2026-12-29T23:12:37Z",
"Priority": "Low",
"LineCount": 36
},
{
"Reference": "ORD-018867",
"CustomerName": "Rapid Stone Works",
"Country": "BE",
"Status": "Closed",
"Total": 47458.87,
"CreatedAt": "2026-12-29T00:33:53Z",
"Priority": "High",
"LineCount": 27
},
{
"Reference": "ORD-026162",
"CustomerName": "Ever Pulse Partners",
"Country": "BE",
"Status": "Closed",
"Total": 26016.07,
"CreatedAt": "2026-12-28T05:15:43Z",
"Priority": "Medium",
"LineCount": 28
},
{
"Reference": "ORD-046157",
"CustomerName": "Nova Pulse Retail",
"Country": "BE",
"Status": "Open",
"Total": 23058.82,
"CreatedAt": "2026-12-28T04:01:12Z",
"Priority": "Medium",
"LineCount": 26
},
{
"Reference": "ORD-002975",
"CustomerName": "Grand Bridge Works",
"Country": "BE",
"Status": "Open",
"Total": 19906.62,
"CreatedAt": "2026-12-28T00:22:41Z",
"Priority": "Critical",
"LineCount": 27
},
{
"Reference": "ORD-040818",
"CustomerName": "Urban Pulse Logistics",
"Country": "BE",
"Status": "Closed",
"Total": 37161.98,
"CreatedAt": "2026-12-27T23:30:24Z",
"Priority": "Low",
"LineCount": 34
},
{
"Reference": "ORD-049049",
"CustomerName": "Global Point Labs",
"Country": "BE",
"Status": "Cancelled",
"Total": 42261.63,
"CreatedAt": "2026-12-27T12:42:30Z",
"Priority": "High",
"LineCount": 14
},
{
"Reference": "ORD-031509",
"CustomerName": "Prime Bridge Retail",
"Country": "BE",
"Status": "Cancelled",
"Total": 7585.08,
"CreatedAt": "2026-12-27T07:48:10Z",
"Priority": "High",
"LineCount": 7
},
{
"Reference": "ORD-026778",
"CustomerName": "Prime Stone Partners",
"Country": "BE",
"Status": "Closed",
"Total": 38421.08,
"CreatedAt": "2026-12-27T07:22:19Z",
"Priority": "High",
"LineCount": 14
},
{
"Reference": "ORD-041316",
"CustomerName": "Blue Market Partners",
"Country": "BE",
"Status": "Pending",
"Total": 7069.56,
"CreatedAt": "2026-12-27T03:12:04Z",
"Priority": "High",
"LineCount": 30
},
{
"Reference": "ORD-049587",
"CustomerName": "Silver Market Systems",
"Country": "BE",
"Status": "Pending",
"Total": 10363.81,
"CreatedAt": "2026-12-26T22:52:41Z",
"Priority": "Critical",
"LineCount": 5
},
{
"Reference": "ORD-013334",
"CustomerName": "North Line Supplies",
"Country": "BE",
"Status": "Pending",
"Total": 30591.05,
"CreatedAt": "2026-12-26T22:42:30Z",
"Priority": "Critical",
"LineCount": 21
},
{
"Reference": "ORD-025056",
"CustomerName": "Prime Forest Systems",
"Country": "BE",
"Status": "Pending",
"Total": 32004.85,
"CreatedAt": "2026-12-26T11:59:59Z",
"Priority": "Critical",
"LineCount": 3
},
{
"Reference": "ORD-017383",
"CustomerName": "Urban Market Works",
"Country": "BE",
"Status": "Pending",
"Total": 21425.98,
"CreatedAt": "2026-12-26T01:00:25Z",
"Priority": "Low",
"LineCount": 40
},
{
"Reference": "ORD-001160",
"CustomerName": "Urban Bridge Works",
"Country": "BE",
"Status": "Pending",
"Total": 19439.16,
"CreatedAt": "2026-12-26T00:18:51Z",
"Priority": "Critical",
"LineCount": 3
},
{
"Reference": "ORD-000928",
"CustomerName": "Silver Stone Labs",
"Country": "BE",
"Status": "Open",
"Total": 7475.70,
"CreatedAt": "2026-12-25T15:23:17Z",
"Priority": "High",
"LineCount": 24
},
{
"Reference": "ORD-038343",
"CustomerName": "Summit Line Logistics",
"Country": "BE",
"Status": "Pending",
"Total": 37194.17,
"CreatedAt": "2026-12-25T11:44:30Z",
"Priority": "Medium",
"LineCount": 38
},
{
"Reference": "ORD-035173",
"CustomerName": "Rapid Peak Trading",
"Country": "BE",
"Status": "Cancelled",
"Total": 37415.40,
"CreatedAt": "2026-12-25T01:50:26Z",
"Priority": "Medium",
"LineCount": 17
},
{
"Reference": "ORD-003945",
"CustomerName": "Urban Harbor Logistics",
"Country": "BE",
"Status": "Cancelled",
"Total": 37723.34,
"CreatedAt": "2026-12-24T23:03:04Z",
"Priority": "Low",
"LineCount": 35
},
{
"Reference": "ORD-046432",
"CustomerName": "Global Grid Holdings",
"Country": "BE",
"Status": "Open",
"Total": 22829.66,
"CreatedAt": "2026-12-24T19:49:43Z",
"Priority": "Critical",
"LineCount": 26
},
{
"Reference": "ORD-021510",
"CustomerName": "Rapid Point Labs",
"Country": "BE",
"Status": "Closed",
"Total": 35590.45,
"CreatedAt": "2026-12-24T14:22:59Z",
"Priority": "Medium",
"LineCount": 32
}
]Without a license NetlyDB runs as the Community edition: the complete embedded, single-node engine. Enterprise adds the modules to operate, integrate and distribute.
The complete embedded database, for any .NET 10 application.
Use governed by your license agreement with NetlySoft. Currently distributed through an early-access package feed.
Get startedEverything in Community, plus the modules to operate, integrate and distribute.
Licenses are signed tokens verified offline. No license server, no call home. Enabling an Enterprise feature without a valid license fails at startup with a clear error; an expired license keeps working during a grace period.
How licensing worksNetlyDB is released to early-access users through a restricted package feed (latest 1.2.0). It is not yet on NuGet.org. What is available, what is being built and what is not planned, stated plainly.
1.2.0 brings a faster engine and stricter recovery, after 1.1.0 added clustering across machines. The release notes list every change; the documentation says, per capability, which release delivers it.
Storage abstractions, sharding, persistence and indexing foundations.
Binary document storage for blobs, to support all types of files.
Operational views, reusable UI components and system metrics.
First peer-to-peer node setup and replication groundwork.
Strongly typed collection registration.
Nested, compound and stale-index handling improved.
Thumbnails, previews and video streaming.
Queue-driven replication over gRPC, with a WebSocket control channel.
Queue depth, active replication and cluster heartbeat diagnostics.
Snapshot repair, stale checkpoint recovery and stronger replication negotiation.
Per-document time-to-live and background cleanup.
Update and delete queries through the shared query pipeline.
Fault injection, partitions, corrupted snapshots and convergence validation.
MCP tooling with structured, read-only query tools for AI agents.
A dedicated engineering phase on correctness rather than features:
An explicit engine state machine, exclusive store ownership and a write-admission gate.
One mutation pipeline over a versioned, checksummed write-ahead log, with resolvable outcomes.
Atomically published snapshot generations and deterministic recovery that stops on ambiguity.
Versioned index generations the planner respects, and one semantic model behind every query front end.
Stated storage-provider guarantees, and replication with provenance, de-duplication and negotiated protocol versions.
Published diagnostic code and metric catalogues, health projections, an audit trail and offline store inspection.
Certified and released to early-access users in September 2026, followed by servicing releases 1.0.1 and 1.0.2.
Cross-machine clustering, optional modules that are truly optional, and safer listener defaults.
Benchmark-driven optimisation - faster scans, queries, recovery and index rebuilds, and snapshots that no longer block writes - and stricter recovery that refuses a store it cannot fully verify.
The real engine running in a browser worker on OPFS storage, recovering after the worker or the whole browser is killed: the basis for web apps that load once and then work fully offline. Planned for release 1.3.
Add one package, register one line, and you have a working database with documents, files and search. Everything else is a switch you turn on later.