docker-compose.yml

# soju-webirc-forward reference Docker Compose file.
#
# Copy this file and adjust paths / secrets to fit your deployment.
# Two things must be provided before starting the stack:
#   1. A working config.ini (see config.example.ini) mounted at /etc/soju/config
#   2. The SOJU_GATEWAY_TOKEN environment variable (see .env.example) that
#      protects the HTTP admin gateway.

services:
  soju:
    restart: always
    container_name: soju-webirc-forward
    build: .
    # network_mode: host is convenient when the upstream IRC server enforces
    # per-IP bans/z-lines against Docker's default bridge network.
    network_mode: host
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      # Bouncer configuration (edit before starting).
      - ./config/config.ini:/etc/soju/config:ro
      # Persistent runtime data (SQLite database, message logs, ...).
      - ./data:/var/lib/soju/
      # Optionally mount TLS certs used by soju itself; adjust to your setup.
      # - ./certs:/var/lib/soju/certs:ro
    environment:
      # Required: authentication token for the HTTP admin gateway.
      - SOJU_GATEWAY_TOKEN=${SOJU_GATEWAY_TOKEN:?SOJU_GATEWAY_TOKEN must be set}
      # Optional: HTTP gateway port (defaults to 10001 inside the container).
      - SOJU_GATEWAY_PORT=${SOJU_GATEWAY_PORT:-10001}
    # When using host networking, ports come from config.ini (IRC) and
    # SOJU_GATEWAY_PORT (HTTP). Without host networking, uncomment:
    # ports:
    #   - "6697:6697"
    #   - "${SOJU_GATEWAY_PORT:-10001}:${SOJU_GATEWAY_PORT:-10001}"