BetterDesk/docker-compose.single.yml

# BetterDesk — Simplified Docker Compose (Single Container)
# ===========================================================
#
# All-in-one: Go server + Node.js console in a single container.
#
# Quick start (SQLite — default):
#   docker compose -f docker-compose.single.yml up -d --build
#
# With PostgreSQL:
#   PG_PASSWORD=YourStrongPasswordHere \
#   DB_TYPE=postgres DATABASE_URL=postgres://betterdesk:YourStrongPasswordHere@postgres:5432/betterdesk \
#     docker compose -f docker-compose.single.yml --profile postgres up -d --build
#
#   Or create a .env file:
#     DB_TYPE=postgres
#     DATABASE_URL=postgres://betterdesk:YourStrongPasswordHere@postgres:5432/betterdesk
#     PG_PASSWORD=YourStrongPasswordHere
#   Then: docker compose -f docker-compose.single.yml --profile postgres up -d --build
#
# Access:
#   Web Console: http://localhost:5000
#   Admin password: auto-generated unless ADMIN_PASSWORD is set before first start

services:
  # BetterDesk All-in-One (Go server + Node.js console)
  betterdesk:
    build:
      context: .
      dockerfile: Dockerfile
    image: betterdesk:local
    pull_policy: never
    container_name: betterdesk
    hostname: betterdesk
    ports:
      - "5000:5000"             # Web Console (LAN)
      - "21115:21115"           # NAT type test
      - "21116:21116/tcp"       # Signal TCP
      - "21116:21116/udp"       # Signal UDP
      - "21117:21117"           # Relay TCP
      - "21118:21118"           # WebSocket Signal
      - "21119:21119"           # WebSocket Relay
      - "21121:21121"           # HTTP API (RustDesk client + REST, WAN-facing)
    volumes:
      - betterdesk-data:/opt/rustdesk
      - console-data:/app/data
    environment:
      - NODE_ENV=production
      - PORT=5000
      - HOST=0.0.0.0
      - API_HOST=0.0.0.0
      - API_ENABLED=false
      - ENCRYPTED_ONLY=1
      - SERVER_BACKEND=betterdesk
      - HBBS_API_URL=http://127.0.0.1:21121/api
      - BETTERDESK_API_URL=http://127.0.0.1:21121/api
      - RUSTDESK_PATH=/opt/rustdesk
      - DATA_DIR=/app/data
      - DB_PATH=/opt/rustdesk/db_v2.sqlite3
      - PUB_KEY_PATH=/opt/rustdesk/id_ed25519.pub
      - API_KEY_PATH=/opt/rustdesk/.api_key
      - SESSION_SECRET=${SESSION_SECRET:-}
      - DOCKER=true
      # Database — defaults to SQLite; set via .env or command line for PostgreSQL
      - DB_TYPE=${DB_TYPE:-sqlite}
      - DATABASE_URL=${DATABASE_URL:-}
      - DB_URL=${DATABASE_URL:-}
      # Relay server address (public IP or domain).
      # Auto-detected if not set. MUST be set if auto-detection returns
      # Docker internal IP (172.x.x.x) — remote relay connections will fail otherwise.
      - RELAY_SERVERS=${RELAY_SERVERS:-}
      # Raise this for very large NAT/proxy deployments; 0 disables signal rate limiting.
      - SIGNAL_RATE_LIMIT_PER_IP=${SIGNAL_RATE_LIMIT_PER_IP:-20}
      # Enrollment policy. Fresh volumes default to "managed" (operator approves
      # new devices); pre-existing volumes keep their current mode. Override with
      # "open", "managed", or "locked".
      - ENROLLMENT_MODE=${ENROLLMENT_MODE:-}
      - NTP_SERVERS=${NTP_SERVERS:-pool.ntp.org,time.google.com,time.cloudflare.com}
      - BILLING_MAX_CLOCK_SKEW_MS=${BILLING_MAX_CLOCK_SKEW_MS:-2000}
      - BILLING_REQUIRE_SYNCED_CLOCK=${BILLING_REQUIRE_SYNCED_CLOCK:-1}
      - BILLING_TRUST_OS_NTP=${BILLING_TRUST_OS_NTP:-Y}
      # Panel folders/groups for RustDesk client (SQLite — same container as console).
      - AUTH_DB_PATH=/app/data/auth.db
      # Admin credentials (first run only; existing users are not overwritten):
      #   ADMIN_PASSWORD=YourSecurePassword123 docker compose -f docker-compose.single.yml up -d --build
      - INIT_ADMIN_USER=${ADMIN_USERNAME:-admin}
      - INIT_ADMIN_PASS=${ADMIN_PASSWORD:-}
      - DEFAULT_ADMIN_USERNAME=${ADMIN_USERNAME:-admin}
      - DEFAULT_ADMIN_PASSWORD=${ADMIN_PASSWORD:-}
    restart: unless-stopped
    # SECURITY (audit fix L-02, 2026-04-10): drop all capabilities except
    # those needed by the entrypoint to chown volumes + su-exec to non-root.
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - SETUID
      - SETGID
      - CHOWN
      - FOWNER
    healthcheck:
      test: ["CMD-SHELL", "curl -sf http://localhost:21121/api/health && curl -sf http://localhost:5000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 45s

  # PostgreSQL (optional — use with --profile postgres)
  postgres:
    image: postgres:16-alpine
    container_name: betterdesk-postgres
    environment:
      - POSTGRES_USER=betterdesk
      # BD-2026-007: PG_PASSWORD MUST be set explicitly — do not use default values in production
      - POSTGRES_PASSWORD=${PG_PASSWORD:?PG_PASSWORD must be set for PostgreSQL}
      - POSTGRES_DB=betterdesk
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped
    # L-02: drop caps for PostgreSQL; gosu needs SETUID/SETGID to drop root.
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - SETUID
      - SETGID
      - CHOWN
      - FOWNER
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U betterdesk"]
      interval: 10s
      timeout: 5s
      retries: 5
    profiles:
      - postgres

  # Nginx Reverse Proxy (optional — use with --profile nginx)
  nginx:
    image: nginx:alpine
    container_name: betterdesk-nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./ssl:/etc/nginx/ssl:ro
    restart: unless-stopped
    depends_on:
      - betterdesk
    profiles:
      - nginx

volumes:
  betterdesk-data:
  console-data:
  postgres-data:

networks:
  default:
    name: betterdesk-net