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
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
go install github.com/genesisdb-io/genesisdb/v2/cmd/genesisdb@latestFrom source
git clone https://github.com/genesisdb-io/genesisdb
cd genesisdb
make build # produces ./bin/genesisdbBuilding needs Go 1.26.10 or a newer patched release.
Run
export GENESISDB_AUTH_TOKEN="$(openssl rand -hex 32)"
genesisdbThe 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
[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