Docker

The server Dockerfile builds a single runtime image. It runs the app process as a non-root user, exposes port 3000, and includes a HEALTHCHECK.

Run

docker build -t tinyreplay .
docker run --rm -p 3000:3000 -v "$(pwd)/data:/app/data" tinyreplay

Persisting data

Everything lives in one SQLite file under /app/data. Mount that directory to keep your sessions across container restarts and upgrades:

-v $(pwd)/data:/app/data

The database (and its WAL sidecar files) are created automatically on first run.

Configuration

Pass configuration as environment variables:

docker run -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  -e DASHBOARD_PASSWORD=replace-with-a-password \
  -e RETENTION_DAYS=30 \
  -e ALLOWED_ORIGINS=https://app.example.com \
  tinyreplay

Every variable is documented in Env vars.

Compose

services:
  tinyreplay:
    build: .
    image: tinyreplay
    ports:
      - '3000:3000'
    volumes:
      - ./data:/app/data
    environment:
      RETENTION_DAYS: '30'
    restart: unless-stopped

Health

The container's HEALTHCHECK probes /api/health, which returns {"ok":true,...}. Use it for orchestrator readiness checks:

curl -i http://localhost:3000/api/health

Next

Lock it down with Auth, then set a retention policy.