Skip to content

Installation

For RHEL, AlmaLinux, Rocky Linux 9, download from GitHub Releases:

bash
# x86_64
sudo rpm -i mygramdb-*.el9.x86_64.rpm

# ARM64
sudo rpm -i mygramdb-*.el9.aarch64.rpm

This installs:

  • /usr/bin/mygramdb - Server binary
  • /usr/bin/mygram-cli - CLI client
  • /etc/mygramdb/config.yaml - Sample configuration
  • systemd service file

Start the service:

bash
sudo systemctl enable --now mygramdb

Docker

bash
docker pull ghcr.io/libraz/mygramdb:latest

docker run -d \
  -p 11016:11016 \
  -p 8080:8080 \
  -v /path/to/config.yaml:/etc/mygramdb/config.yaml \
  ghcr.io/libraz/mygramdb:latest

Available tags:

  • ghcr.io/libraz/mygramdb:1.3.8
  • ghcr.io/libraz/mygramdb:latest

Supports both linux/amd64 and linux/arm64.

Build from Source

Prerequisites

RHEL/AlmaLinux/Rocky Linux:

bash
sudo dnf install -y gcc-c++ cmake mysql-devel libicu-devel

Ubuntu/Debian:

bash
sudo apt-get update
sudo apt-get install -y pkg-config libmysqlclient-dev libicu-dev cmake g++

macOS:

bash
brew install cmake [email protected] icu4c pkg-config

Build

bash
git clone https://github.com/libraz/mygram-db.git
cd mygram-db
make

Install System-wide

bash
sudo make install

Running as a Service

If you built from source (RPM already includes the service):

Create User

bash
sudo useradd -r -s /bin/false mygramdb

Setup Directories

bash
sudo mkdir -p /etc/mygramdb /var/lib/mygramdb/dumps
sudo chown -R mygramdb:mygramdb /var/lib/mygramdb

Install systemd Service

bash
sudo cp support/systemd/mygramdb.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now mygramdb

Check Status

bash
sudo systemctl status mygramdb
sudo journalctl -u mygramdb -f

Verify Installation

bash
mygramdb --help
mygram-cli --help

Security Note

CAUTION

MygramDB refuses to run as root for security. Always run it as a dedicated non-privileged user.

Next Steps

Detailed Documentation

Released under the MIT License.