Self-host Scrob

Create a dedicated network

docker network create scrob-net

Start the database

docker run -d
--name scrob-db
--network scrob-net
--restart unless-stopped
-e POSTGRES_USER=scrob
-e POSTGRES_PASSWORD=changeme
-e POSTGRES_DB=scrob
-v scrob_db:/var/lib/postgresql/data
postgres:16-alpine

Start Scrob

docker run -d
--name scrob
--network scrob-net
--restart unless-stopped
-p 7330:7330
-e DATABASE_URL="postgresql+asyncpg://scrob:changeme@scrob-db:5432/scrob"
-e SECRET_KEY="$(openssl rand -hex 32)"
-e TZ=UTC
-v scrob_data:/app/backend/data
bellamy/scrob:latest

Omnibus image (PostgreSQL included - no separate container needed):

docker run -d
--name scrob
--restart unless-stopped
-p 7330:7330
-e SECRET_KEY="$(openssl rand -hex 32)"
-e TZ=UTC
-v scrob_data:/app/backend/data
-v scrob_db:/app/postgres/data
bellamy/scrob:latest-omnibus

1. Download the compose file:

curl -o docker-compose.yaml https://raw.githubusercontent.com/ellite/scrob/main/docker-compose.yaml

2. Edit docker-compose.yaml and replace the required values:

services:
  scrob-db:
    container_name: scrob-db
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: scrob
      POSTGRES_PASSWORD: changeme        # ← change this
      POSTGRES_DB: scrob
    volumes:
      - db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U scrob -d scrob"]
      interval: 5s
      timeout: 5s
      retries: 10

  scrob:
    container_name: scrob
    image: bellamy/scrob:latest
    restart: unless-stopped
    depends_on:
      scrob-db:
        condition: service_healthy
    ports:
      - "7330:7330"
    environment:
      DATABASE_URL: postgresql+asyncpg://scrob:changeme@scrob-db:5432/scrob   # ← match password above
      SECRET_KEY: changeme               # ← generate with: openssl rand -hex 32
      TZ: UTC
    volumes:
      - scrob_data:/app/backend/data

volumes:
  db_data:
  scrob_data:

3. Start:

docker compose up -d