docker-compose.yml

# Production stack (the default): runs the pre-built image from the GitHub
# Container Registry — a single container serving the API + built SPA on one
# port. One command on a LAN host:
#
#   docker compose up -d
#
# Then open http://<host>:8000. Minecraft clients connect on 25565.
# Pin a version with LECTERN_TAG (defaults to :latest), e.g.
#   LECTERN_TAG=1.2.3 docker compose up -d
# To upgrade: `docker compose pull && docker compose up -d`.
#
# To build from source instead of pulling (e.g. local changes), run:
#   docker compose -f docker-compose.dev.yml up
# or `docker build -t lectern .` against the Dockerfile directly.
services:
  lectern:
    container_name: lectern
    image: ghcr.io/kernelcoffee/lectern:${LECTERN_TAG:-latest}
    restart: unless-stopped
    ports:
      - "8000:8000"        # web UI + API
      - "25565:25565"      # Minecraft (single fixed port; see note below)
      - "24454:24454/udp"  # Simple Voice Chat (SVC) voice server
    volumes:
      - lectern_data:/data # db, downloaded JREs, caches, backups, server files
    # NB: 25565 is a single published port. Running several servers at once, or
    # a custom per-server port, needs a published range instead, e.g.
    #   - "25565-25575:25565-25575"

volumes:
  lectern_data: