Docker Setup

Quick Start

docker run -d \
  -p 8080:8080 \
  -v pong-data:/app/data \
  -e ADMIN_API_KEY=pong_mykey \
  ghcr.io/getpong/pong-backend-go:latest

Docker Compose

Create a docker-compose.yml:

services:
  pong:
    image: ghcr.io/getpong/pong-backend-go:latest
    ports:
      - "8080:8080"
    volumes:
      - pong-data:/app/data
    env_file: .env
    restart: unless-stopped

volumes:
  pong-data:

Create a .env file (see Configuration):

ADMIN_API_KEY=pong_mykey
# Optional: enable HTTP auth on monitors (generate with: openssl rand -hex 32)
# ENCRYPTION_KEY=your-64-char-hex-key

Start it:

docker compose up -d

Building from Source

git clone https://github.com/getpong/pong-backend-go.git
cd pong-backend-go
docker build -t pong .
docker run -d -p 8080:8080 -v pong-data:/app/data --env-file .env pong

Data

All data is stored in a single SQLite file at /app/data/ghm.db inside the container. Mount a volume to persist it across restarts.

Updates

docker compose pull
docker compose up -d

Migrations run automatically on startup.