EntglDb Documentation
Welcome to the EntglDb documentation for version 2.1.
What’s New in v2.1
Version 2.1 introduces ContentHash on DocumentMetadata with canonical JSON normalization, major framework targeting changes, and solidifies EntglDb as a P2P synchronization middleware and platform.
- ContentHash: Each document now carries a deterministic SHA-256 content hash for integrity verification
- Framework Targeting: Targets
netstandard2.1andnet10.0(droppednetstandard2.0,net6.0,net8.0) - P2P Sync Correctness: Improved CDC serialization, LWW timestamp handling, and deterministic metadata IDs
- Dynamic Database Paths: Per-collection table support for scalable SQLite persistence
- Full Async BLite: Async read/write operations throughout the BLite persistence layer
- Platform Services: EntglDb is now a P2P platform on which additional services can be built
See the CHANGELOG for complete version history.
Documentation
Getting Started
- Getting Started - Installation, setup, and your first EntglDb application
Core Concepts
- Architecture - Understanding HLC, Gossip Protocol, P2P mesh networking, and the platform model
- API Reference - Complete API documentation and examples
- Querying - Data querying patterns and LINQ support
Persistence & Storage
- Persistence Providers - BLite and EF Core provider comparison and configuration
- Deployment Modes - Single vs Multi-cluster deployment strategies
Networking & Security
- Security - Encryption, authentication, and secure networking
- Conflict Resolution - LWW and Recursive Merge strategies
- Network Telemetry - Monitoring and diagnostics
- Dynamic Reconfiguration - Runtime configuration and leader election
- Remote Peer Configuration - Managing remote peers
Deployment & Operations
- Deployment (LAN) - Platform-specific deployment instructions
- Production Hardening - Configuration, monitoring, and best practices
Cross-Platform Ecosystem
EntglDb is designed as a technology-agnostic protocol. While the .NET implementation is the most mature, the same principles apply across all stacks:
| Language | Repository | Status |
|---|---|---|
| C# / .NET | EntglDb.Net | ✅ Stable (v2.1) |
| Kotlin / Android | EntglDb.Kotlin | ⚠ Alpha |
| Node.js / TypeScript | EntglDb.NodeJs | 🚧 In Development |
| React Native | EntglDb.ReactNative | 🚧 In Development |
All implementations follow the same canonical specifications.
Previous Versions
Downloads
- Download EntglStudio - Standalone tool for managing EntglDb data.