docker-compose.yml

# Lavalink, the audio server the bot uses to play music.
#
# Comes up on any system with Docker — it's the portable alternative to
# `start.bat`, which runs the .jar by hand and only works on Windows.
#
#   docker compose up -d     starts Lavalink
#   docker compose logs -f   follows the logs
#   docker compose down      tears it down
#
# The password comes from `.env` (LAVALINK_SERVER_PASSWORD). The bot reads the
# same one from LAVALINK_PASSWORD: the two have to match.

services:
  lavalink:
    image: ghcr.io/lavalink-devs/lavalink:4
    container_name: nerdbot-lavalink
    restart: unless-stopped
    environment:
      # Lavalink reads application.yml and resolves ${...} from the environment.
      LAVALINK_SERVER_PASSWORD: ${LAVALINK_SERVER_PASSWORD:-youshallnotpass}
      SERVER_PORT: 2333
    volumes:
      - ./lavalink/application.yml:/opt/Lavalink/application.yml:ro
      - lavalink-plugins:/opt/Lavalink/plugins
    ports:
      - "127.0.0.1:2333:2333"   # local only: Lavalink should never be exposed
    healthcheck:
      test: ["CMD-SHELL", "nc -z 127.0.0.1 2333 || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 12
      start_period: 30s

volumes:
  lavalink-plugins: