donti/deltadatabase repository overview

⁠DeltaDatabase

DeltaDatabase is a lightweight, encrypted-at-rest JSON database written in Go. It is designed for production workloads requiring per-entity encryption, JSON Schema validation, and a simple REST/gRPC API.

⁠🚀 Quick Start (Docker)

The fastest way to get started is using the all-in-one image, which contains both the Main and Processing workers.

docker run -d \
  -p 8080:8080 \
  -e ADMIN_KEY=your_secret_admin_key \
  -v delta_data:/shared/db \
  donti/deltadatabase:latest-aio

• Web UI: http://localhost:8080/⁠
• REST API: http://localhost:8080/api/⁠
• Documentation & Source: GitHub Repository⁠

⁠📦 Available Images

⁠🛠️ Key Features

• Encryption at Rest: Every entity is encrypted via AES-256-GCM before hitting the disk.
• Schema Validation: Enforce data integrity using JSON Schema (Draft-07) on every write.
• Smart Caching: Built-in LRU caching ensures high-speed reads for frequently accessed data.
• Flexible Storage: Supports local Shared Filesystems (NFS/CIFS) or S3-compatible backends (AWS S3, MinIO).
• Scalable Architecture: Easily scale by adding more Processing Workers behind a single Main Worker.
• Management UI: Built-in dashboard to manage databases, schemas, and API keys.

⁠🔧 Configuration Reference

Common environment variables and flags:

• ADMIN_KEY: Sets the master admin Bearer token (required).
• S3_ENDPOINT: Set to enable S3 storage (e.g., minio:9000).
• CACHE_SIZE: Number of entities to keep in the LRU cache (default: 256).

⁠📖 Detailed Usage & Deployment

For advanced orchestration (Docker Compose, Kubernetes + HPA) and language-specific client examples (Go, Python, Curl), please visit the official repository:

👉 View Documentation on GitHub⁠