Logo
Logo

Docker

Run GenesisDB with the official multi-arch container image.

Every release publishes a multi-arch image for linux/amd64 and linux/arm64 on Docker Hub (genesisdb/genesisdb) and GitHub Packages (ghcr.io/genesisdb-io/genesisdb).

bash
docker run -d --name genesisdb \
  -p 127.0.0.1:8080:8080 \
  -e GENESISDB_AUTH_TOKEN="$(openssl rand -hex 32)" \
  -e GENESISDB_TZ=Europe/Vienna \
  -e GENESISDB_METRICS=true \
  -v genesisdb-data:/app/data \
  genesisdb/genesisdb:latest

The image runs as UID/GID 10001 and binds to 0.0.0.0 inside the container. A bind-mounted data directory must be writable by that user. Pin a version tag such as genesisdb/genesisdb:2.0.0 in production.

Docker Compose

yaml
services:
  genesisdb:
    image: genesisdb/genesisdb:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      GENESISDB_AUTH_TOKEN: ${GENESISDB_AUTH_TOKEN}
      GENESISDB_TZ: Europe/Vienna
    volumes:
      - genesisdb-data:/app/data

volumes:
  genesisdb-data:

Every environment variable is listed in Configuration.