Logo
Logo

Binaries

Static GenesisDB binaries for Linux and macOS on amd64 and arm64.

Every release on the GitHub releases page ships static binaries for Linux and macOS on amd64 and arm64, together with a SHA256SUMS file.

Download and verify

bash
VERSION=2.0.0
OS=linux        # or darwin
ARCH=amd64      # or arm64

curl -LO https://github.com/genesisdb-io/genesisdb/releases/download/v$VERSION/genesisdb-$VERSION-$OS-$ARCH.tar.gz
curl -LO https://github.com/genesisdb-io/genesisdb/releases/download/v$VERSION/SHA256SUMS
shasum -a 256 -c SHA256SUMS --ignore-missing

tar -xzf genesisdb-$VERSION-$OS-$ARCH.tar.gz
chmod +x genesisdb
sudo mv genesisdb /usr/local/bin/

With Go

bash
go install github.com/genesisdb-io/genesisdb/v2/cmd/genesisdb@latest

From source

bash
git clone https://github.com/genesisdb-io/genesisdb
cd genesisdb
make build        # produces ./bin/genesisdb

Building needs Go 1.26.10 or a newer patched release.

Run

bash
export GENESISDB_AUTH_TOKEN="$(openssl rand -hex 32)"
genesisdb

The server binds to 127.0.0.1:8080 and creates ./data. Set GENESISDB_HOST=0.0.0.0 to accept remote clients, and configure TLS for that, see Security. Every variable is listed in Configuration.

As a systemd service

ini
[Unit]
Description=GenesisDB
After=network.target

[Service]
User=genesisdb
EnvironmentFile=/etc/genesisdb/env
WorkingDirectory=/var/lib/genesisdb
ExecStart=/usr/local/bin/genesisdb
Restart=on-failure

[Install]
WantedBy=multi-user.target