fix: require Docker Compose v2 in scripts and docs

compose 1.29.2 aborts with KeyError: 'ContainerConfig' against Docker 28,
which broke the deploy on the prod VM.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

scripts/deploy.sh

@@ -6,8 +6,9 @@ set -euo pipefail
 PROXY_DIR="${PROXY_DIR:-/srv/elevenlabs}"
 cd "${PROXY_DIR}"
 
-COMPOSE="docker-compose"
-command -v docker-compose >/dev/null 2>&1 || COMPOSE="docker compose"
+# compose v1 (1.29.x) breaks against Docker 28 with KeyError: 'ContainerConfig' — prefer v2
+COMPOSE="docker compose"
+docker compose version >/dev/null 2>&1 || COMPOSE="docker-compose"
 
 echo "=== [1/4] Pulling latest image ==="
 ${COMPOSE} pull

scripts/install.sh

@@ -8,7 +8,7 @@ REPO_URL="https://github.com/YOUR_ORG/YOUR_REPO.git"  # TODO: replace with actua
 
 echo "=== [1/6] Installing Docker and dependencies ==="
 apt-get update -qq
-apt-get install -y docker.io docker-compose-plugin git curl
+apt-get install -y docker.io docker-compose-v2 git curl
 
 echo "=== [2/6] Enabling Docker ==="
 systemctl enable --now docker
@@ -40,7 +40,7 @@ else
 fi
 
 echo "=== [6/6] Starting containers ==="
-docker-compose up -d
+docker compose up -d
 
 echo ""
 echo "=========================================="
@@ -49,5 +49,5 @@ echo " Health check: curl http://localhost:8082/health"
 echo ""
 echo " IMPORTANT: Edit ${PROXY_DIR}/.env"
 echo "   - Set DOMAIN, ACME_EMAIL and ALLOWED_CIDR"
-echo "   - Then run: docker-compose up -d"
+echo "   - Then run: docker compose up -d"
 echo "=========================================="

scripts/migrate-host-nginx.sh

@@ -40,4 +40,4 @@ ss -tlnp | grep -E ':(80|443)\s' && { echo "Ports 80/443 are still busy — insp
 echo "Ports 80 and 443 are free."
 echo ""
 echo "Backup: ${BACKUP_DIR}"
-echo "Next: cd /srv/elevenlabs && docker-compose pull && docker-compose up -d"
+echo "Next: cd /srv/elevenlabs && docker compose pull && docker compose up -d"