Downloads — CSharpDB

Use the Admin app

A visual workspace for browsing data, running queries, and managing your CSharpDB databases.

CSharpDB Admin Desktop

v4.6.4 · Windows x64 · Portable ZIP

Includes the Admin host and desktop launcher. No separate .NET installation is needed.

Download Admin for Windows Admin checksums

Download, extract, open

Verify the archive, then extract the entire ZIP into a writable folder.
Keep the included admin/ folder next to the launcher.
Open CSharpDB.Admin.Desktop.exe.

Requires the Microsoft Edge WebView2 Runtime; install it if it is missing.

Admin UI guide

Explore Studio: The v4.6.4 desktop app includes SQL Search, Database Documenter, Test Data Generator, and Data Modeler. Follow the Admin guide; v4.6.5 candidate changes require the current source build.

The packaged desktop app is currently Windows-only. To run the browser-based Admin from source on another platform, see the Admin guide; this requires the .NET 10 SDK.

Add CSharpDB to a .NET application

Use the .NET 10 SDK to build your application. These links and the install command select v4.6.4.

dotnet add package CSharpDB --version 4.6.4

CSharpDB

Recommended starting point. The all-in-one package includes the engine, unified client, ADO.NET provider, pipelines, and diagnostics.

Get CSharpDB

CSharpDB.Client

One client API for direct, ADO.NET, HTTP, and gRPC access, including route-aware connections.

Get Client

CSharpDB.Data

The ADO.NET provider for standard connection, command, and data-reader APIs.

Get ADO.NET

CSharpDB.EntityFrameworkCore

The EF Core provider for applications using a DbContext and supported LINQ queries.

Get EF Core

Show the remaining 15 NuGet packages

All 19 published packages are listed on this page, including the four above. Most applications do not need to install each component separately.

CSharpDB.CodeModules
Contracts for C# code modules and stored procedure integration.
CSharpDB.DevOps
Database schema and data compare and deploy services.
CSharpDB.Engine
The Database API and typed document collections.
CSharpDB.EntityFrameworkCore.Tools
Companion tooling for the EF Core provider.
CSharpDB.Execution
Query planning, execution operators, and expression evaluation.
CSharpDB.Generators
Source generators for typed collection serialization.
CSharpDB.ImportExport
Import/export workflows and shared data-transfer services.
CSharpDB.Migration
Migration catalogs, plans, mappings, and validation contracts.
CSharpDB.Migration.DualRun
Bounded read-only query-result comparisons for migration cutovers.
CSharpDB.Observability
Structured events, diagnostics, tracing, and metrics contracts.
CSharpDB.Pipelines
The ETL pipeline engine.
CSharpDB.Primitives
Shared values, schema metadata, and error codes.
CSharpDB.Sql
The SQL tokenizer, parser, syntax tree, and script splitter.
CSharpDB.Storage
Page storage, B+trees, write-ahead logging, and file I/O.
CSharpDB.Storage.Diagnostics
Storage inspection and integrity checking.

.NET getting started · EF Core guide and limitations

Run the database server

CSharpDB Daemon owns the database file and lets applications connect over HTTP or gRPC. These v4.6.4 archives are self-contained: no separate .NET installation is needed.

Windows x64

ZIP archive with Windows service scripts.

Download Windows server

Linux x64

Tar archive with systemd service scripts.

Download Linux server

macOS Apple silicon

ARM64 tar archive with launchd service scripts.

Download macOS server

Verify and extract the archive, then use its matching service installer. Service installation requires administrator privileges. Configure authentication and network access before allowing remote connections.

Server checksums Install the server Connect and configure

Use CLI and migration tools

Run SQL interactively, inspect storage, and use retained import/export and migration workflows. The v4.6.4 migration archives include the CLI and its applicable optional adapters.

Windows x64

ZIP · Requires .NET 10 Runtime.

Download Windows CLI

Linux x64

Tar archive · Requires .NET 10 Runtime.

Download Linux CLI

macOS Apple silicon

ARM64 tar archive · Requires .NET 10 Runtime.

Download macOS CLI

Install the .NET 10 Runtime for your OS and architecture. Verify the archive and extract it without changing its directory layout. Run csharpdb from the extracted folder, or follow the included installer instructions.

Keep the adapters/ folders, notices, and licenses together. Access is Windows-only and needs a separately installed, bitness-compatible ACE provider. Shipping an adapter does not establish broad live-provider qualification; review the migration guide's restrictions before using production data.

CLI checksums Install the CLI Migration guide CLI reference

Build the base CLI from source

From a repository checkout, use the .NET 10 SDK. This builds the base CLI, not the optional Access, SQL Server, or MySQL worker layout.

dotnet publish src/CSharpDB.Cli -c Release -o ./publish

The output requires .NET 10 Runtime. For the complete migration archive build process, see the migration packaging instructions.

Use native libraries

NativeAOT shared libraries for C-compatible language bindings, including Python, JavaScript, Go, and Rust. These v4.6.4 libraries do not require .NET at the call site; your language runtime and OS dependencies still apply.

Windows x64

CSharpDB.Native.dll

Download DLL

Linux x64

CSharpDB.Native.so

Download shared object

macOS Apple silicon

CSharpDB.Native.dylib · ARM64

Download dylib

Use the header and library from the same release. Place the library where your binding expects it; the native FFI tutorials describe each language's setup.

Download C header Native FFI setup and examples

JavaScript / TypeScript: build the client from source

The Node client is available in the repository, but there is currently no published csharpdb npm package. Use a source build instead. The wrapper declares Node.js 18 or newer; use a maintained Node.js release.

For a build matching the downloads above, start with a fresh v4.6.4 checkout, then install the build dependencies and compile the wrapper:

git clone --branch v4.6.4 --depth 1 https://github.com/MaxAkbar/CSharpDB.git CSharpDB-v4.6.4
cd CSharpDB-v4.6.4/clients/node
npm install
node node_modules/typescript/bin/tsc
npm pack

Install the resulting local .tgz into your own project with npm install /path/to/csharpdb-1.0.0.tgz. The wrapper has its own version; it is not the database release version.

Download the matching native library above. Set CSHARPDB_NATIVE_PATH to its absolute path, or put the library in your application's native/ directory. You do not need the .NET SDK when using a prebuilt native library.

JavaScript examples · Wrapper API and type limitations

Verify your download

Before extracting an archive, compare its SHA-256 hash with the matching checksum file linked above. Use the file from the same release: Admin, server, and migration archives have separate checksum lists.

Show checksum commands

Replace the example filename with the archive you downloaded. On Windows, use PowerShell:

Get-FileHash -Algorithm SHA256 -LiteralPath .\csharpdb-admin-desktop-v4.6.4-win-x64.zip

On Linux, place the checksum file next to the downloaded archive:

sha256sum --check --ignore-missing SHA256SUMS.txt

On macOS, compute the hash and compare it with the checksum list:

shasum -a 256 csharpdb-daemon-v4.6.4-osx-arm64.tar.gz

The native libraries and C header do not have a separate checksum-list asset in this release; do not use the server checksum list for those files. The package manifest describes the NuGet package set, not native-library checksums.

Release notes and older versions

These downloads are pinned to the verified stable release. Source builds may contain newer, unreleased features.

View v4.6.4 release All GitHub releases Changelog