Download GitRiver

docker pull gitriver/gitriver:latest

.env

DB_USER=gitriver
DB_PASS=changeme
DB_NAME=gitriver

docker-compose.yml

services:
  postgres:
    image: postgres:17-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASS}
      POSTGRES_DB: ${DB_NAME}
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
      interval: 5s
      retries: 5

  gitriver:
    image: gitriver/gitriver:latest
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    ports:
      - "3000:3000"
    environment:
      GITRIVER_DB_HOST: postgres
      GITRIVER_DB_PORT: 5432
      GITRIVER_DB_USER: ${DB_USER}
      GITRIVER_DB_PASS: ${DB_PASS}
      GITRIVER_DB_NAME: ${DB_NAME}
    volumes:
      - ./data/gitriver:/var/lib/gitriver
      - /var/run/docker.sock:/var/run/docker.sock

docker compose up -d:

docker compose up -d

Open http://localhost:3000 - the setup wizard will create an administrator.

Replace changeme with a strong password in the .env file.