Docs / Installation

Installation Guide

This guide covers all installation methods for Maree-DB. All downloads are served from dist.mareedb.com.

System Requirements

Component	Minimum	Recommended
CPU	2 cores, x86_64 or ARM64	4+ cores
RAM	4 GB	16 GB+
Disk	10 GB (SSD)	100 GB+ NVMe SSD
OS (Linux)	Kernel 4.15+	Kernel 6.x (latest LTS)
OS (macOS)	macOS 12 Monterey	macOS 14 Sonoma+
IoT	64 KB RAM, ARM Cortex-M	256 KB+ RAM

Linux - One-Line Installer (Recommended)

curl -sSL https://dist.mareedb.com/install.sh | bash

Installs to /usr/local/bin/. Supports Ubuntu, Debian, RHEL, CentOS, Fedora, and Alpine.

Linux - Manual tar.gz

# x86_64
curl -O https://dist.mareedb.com/releases/latest/maree-db-linux-x86_64.tar.gz
tar xzf maree-db-linux-x86_64.tar.gz
sudo mv maree-db-server maree-db-cli /usr/local/bin/
sudo chmod +x /usr/local/bin/maree-db-server /usr/local/bin/maree-db-cli

# ARM64 (Graviton, Ampere, Raspberry Pi 4+)
curl -O https://dist.mareedb.com/releases/latest/maree-db-linux-arm64.tar.gz

Linux - systemd Service

# Create service file
sudo maree-db-cli install --systemd

# Enable and start
sudo systemctl enable maree-db
sudo systemctl start maree-db
sudo systemctl status maree-db

macOS

# Apple Silicon (M1/M2/M3/M4)
curl -O https://dist.mareedb.com/releases/latest/maree-db-macos-arm64.tar.gz
tar xzf maree-db-macos-arm64.tar.gz
sudo mv maree-db-server maree-db-cli /usr/local/bin/

# Remove Gatekeeper quarantine
xattr -dr com.apple.quarantine /usr/local/bin/maree-db-server

# Intel Mac
curl -O https://dist.mareedb.com/releases/latest/maree-db-macos-x86_64.tar.gz

Docker

Maree-DB Docker images are served from dist.mareedb.com/docker/ - NOT Docker Hub or any third-party registry.

docker pull dist.mareedb.com/docker/mareedb:latest

docker run -d \
  --name maree-db \
  -p 3306:3306 -p 5432:5432 -p 6379:6379 -p 8080:8080 \
  -v mareedb-data:/var/lib/mareedb \
  -e MAREEDB_ADMIN_PASSWORD=your_secure_password \
  dist.mareedb.com/docker/mareedb:latest

Kubernetes (Helm)

# Add Maree-DB Helm repository
helm repo add mareedb https://dist.mareedb.com/helm
helm repo update

# Install with default settings
helm install maree-db mareedb/maree-db \
  --namespace database \
  --create-namespace \
  --set licence.key=YOUR_LICENCE_KEY

cPanel Plugin

The Maree-DB cPanel plugin replaces MySQL transparently. All existing WordPress sites and cPanel applications continue working without any changes.

# Download the cPanel plugin
curl -O https://dist.mareedb.com/releases/latest/maree-db-cpanel-plugin.tar.gz

# Install via WHM Plugin Manager
# Or from the command line:
sudo /usr/local/cpanel/3rdparty/bin/installplugin maree-db-cpanel-plugin.tar.gz

Post-Installation

# Verify binary integrity
maree-db-server --verify-binary

# Run health check
maree-db-server verify --all

# Change the admin password
maree-db-cli user set-password admin

# Activate your licence (skip for Community)
maree-db-cli licence activate --online

Verify Checksums

# Download checksum file
curl -O https://dist.mareedb.com/releases/latest/checksums.txt

# Verify (Linux)
sha256sum -c checksums.txt

# Verify (macOS)
shasum -a 256 -c checksums.txt