Maree-DB Documentation

Install Maree-DB, run your first query, and connect an existing application in under 5 minutes.

Platform-specific installation instructions, system requirements, and first-boot configuration for every supported OS and architecture.

Every TOML configuration key — storage paths, memory limits, wire protocol ports, TLS settings, clustering options, and performance tuning.

Complete SQL:2023 reference — DDL, DML, window functions, CTEs, JSON operators, vector search, graph traversal, time-series functions, and spatial queries.

How to use all 8 data models — relational, KV, document, vector, graph, time-series, columnar, and spatial — in a single database and a single query.

ACID transactions with Serializable Snapshot Isolation, multi-version concurrency control, and point-in-time read consistency.

MySQL 8.0 protocol on port 3306. Compatible with all MySQL client libraries, ORMs, and tools — connect with zero code changes.

PostgreSQL FE/BE protocol v3 on port 5432. Full extended query, prepared statements, COPY, and LISTEN/NOTIFY support.

MS-TDS 7.4 on port 1433. Compatible with ADO.NET, JDBC, ODBC, and all SQL Server client libraries.

RESP protocol on port 6379. Every Redis client in every language connects without changes. All Redis data types supported.

JSON over HTTP on port 8080. Query, insert, and manage all data models via simple HTTP requests — no special client required.

The built-in web-based admin portal — schema browser, query editor, real-time metrics, user management, backup scheduling, and tamper-evident audit log viewer.

Complete reference for the mareedb command-line tool — start/stop, backup, restore, migrate, activate, self-verify, cluster management, and more.

How Maree-DB verifies its own correctness at boot and on demand — cryptographic integrity checks, internal assertion suite, and what to do when verification fails.

Encryption at rest (AES-256-GCM), TLS 1.3 in transit, post-quantum key exchange, RBAC, row-level security, GDPR/HIPAA/SOC2 compliance SQL, and tamper-evident audit chains.

How the tamper-evident integrity chain works — every write is permanently linked into a cryptographic chain signed by the server's Ed25519 key. Cannot be altered without detection.

Kernel-level process monitoring that detects and responds to ransomware, unauthorised memory access, and suspicious process behaviour in real time.

Set up WAL streaming replication, configure a multi-node cluster, enable Byzantine fault tolerant consensus for enterprise deployments, and manage rolling upgrades.

Automatic cluster node discovery — nodes find each other via broadcast, DNS-SD, or static peer lists. New nodes join the cluster and begin replicating within seconds.

Built-in Prometheus-compatible metrics endpoint, real-time cluster health dashboard, lag monitoring, and automatic alerting for node failures and consensus events.

Full migration guide — zero-downtime CDC migration from 13 source databases, schema translation, data type mapping, validation, and cutover procedures.

Don't want to migrate your data? Use Maree-DB as a drop-in replacement via wire protocol compatibility. Your app connects — no data movement required.

Complete HTTP/JSON API reference — all endpoints, authentication, request/response schemas, error codes, and rate limits.

Subscribe to real-time change events from any table or collection. Used for event-driven architectures, cache invalidation, and live replication.

Build AI agents that query, reason over, and act on your database data entirely on-premises — no external API calls, no data leaving your environment.

Everything authorised resellers need — how to apply, partner portal access, wholesale pricing tiers, adding customers, generating licence keys, renewals, billing, and escalation contacts.