#!/usr/bin/env bash # setup-runner-tls.sh # # One-time host setup for per-runner subdomain TLS. Run as root on the BMM # host AFTER you've done the prereqs below. Idempotent — safe to re-run. # # What it does: # 1. Creates /opt/buildmymcpserver/runner-map/ (volume-mounted into bmm-api # and bmm-generator — they drop one .conf fragment per live runner) # 2. Installs an nginx vhost that catches *.mcp.buildmymcpserver.com, # reads slug→port from a combined map file, and reverse-proxies to the # runner on localhost # 3. Installs a systemd service that inotify-watches the map dir, combines # all fragments into a single map file, and reloads nginx on any change # # After this script: # - In docker-compose.prod.yml, add a volume mount to BOTH api and generator: # volumes: # - /opt/buildmymcpserver/runner-map:/var/runner-map # - In .env.production, add: # MCP_DOMAIN=mcp.buildmymcpserver.com # - docker compose up -d --force-recreate api generator # - From now on every deployed runner gets https://.mcp.buildmymcpserver.com # # ─── PREREQS (do these in Cloudflare dashboard before running) ─────────── # A. DNS: Add an A-record '*.mcp.buildmymcpserver.com' → 213.239.213.217 # Proxy status: Proxied (orange cloud) # B. SSL: Cloudflare → SSL/TLS → Origin Server → Create Certificate # Hostnames: *.mcp.buildmymcpserver.com, mcp.buildmymcpserver.com # Save the .crt and .key to: # /etc/ssl/buildmymcpserver/mcp-runners.crt (mode 644) # /etc/ssl/buildmymcpserver/mcp-runners.key (mode 600, root:root) # C. SSL mode: Cloudflare → SSL/TLS → Overview → set to "Full (strict)" # (you've likely already set this for api.* — same setting) # # Run: sudo bash scripts/setup-runner-tls.sh set -euo pipefail if [[ "${EUID}" -ne 0 ]]; then echo "Run as root (sudo bash $0)." exit 1 fi MAP_DIR="/opt/buildmymcpserver/runner-map" COMBINED="/opt/buildmymcpserver/runner-map.combined" VHOST_DST="/etc/nginx/sites-available/bmm-mcp-runners" VHOST_LNK="/etc/nginx/sites-enabled/bmm-mcp-runners" CERT="/etc/ssl/buildmymcpserver/mcp-runners.crt" KEY="/etc/ssl/buildmymcpserver/mcp-runners.key" echo "─── checking prereqs ───────────────────────────────────────" for f in "$CERT" "$KEY"; do if [[ ! -f "$f" ]]; then echo "MISSING: $f — see PREREQS at the top of this script." exit 1 fi done if ! command -v inotifywait >/dev/null; then echo "Installing inotify-tools…" apt-get update -qq apt-get install -y -qq inotify-tools fi echo "─── creating map dir + initial combined file ──────────────" mkdir -p "$MAP_DIR" chmod 755 "$MAP_DIR" touch "$COMBINED" chmod 644 "$COMBINED" echo "─── writing nginx vhost ──────────────────────────────────" cat > "$VHOST_DST" <<'NGINX' # BMM per-runner subdomain proxy. Map file (slug→port) is regenerated by # the bmm-api and bmm-generator containers; a systemd inotify watcher # combines them into the included file and runs `nginx -s reload`. map $http_host $bmm_runner_port { default 0; include /opt/buildmymcpserver/runner-map.combined; } server { listen 80; listen [::]:80; listen 443 ssl http2; listen [::]:443 ssl http2; server_name ~^(?[a-z0-9][a-z0-9-]*)\.mcp\.buildmymcpserver\.com$; ssl_certificate /etc/ssl/buildmymcpserver/mcp-runners.crt; ssl_certificate_key /etc/ssl/buildmymcpserver/mcp-runners.key; client_max_body_size 4M; # Unknown slugs land here — return 404 instead of a confusing default vhost. if ($bmm_runner_port = 0) { return 404; } location / { proxy_pass http://127.0.0.1:$bmm_runner_port; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto https; # MCP uses Streamable HTTP — disable buffering so response chunks flow. proxy_buffering off; proxy_cache off; proxy_read_timeout 600s; } } NGINX ln -sf "$VHOST_DST" "$VHOST_LNK" echo "─── writing systemd watcher service ──────────────────────" cat > /etc/systemd/system/bmm-runner-map.service </dev/null > ${COMBINED} || true; /usr/sbin/nginx -t && /usr/sbin/nginx -s reload || true' ExecStart=/bin/bash -c 'while inotifywait -q -e create,modify,delete,moved_to,moved_from ${MAP_DIR}; do cat ${MAP_DIR}/*.conf 2>/dev/null > ${COMBINED} || true; /usr/sbin/nginx -t && /usr/sbin/nginx -s reload; done' Restart=always RestartSec=2 [Install] WantedBy=multi-user.target EOF systemctl daemon-reload systemctl enable --now bmm-runner-map echo "─── verifying nginx config + reload ──────────────────────" nginx -t nginx -s reload || true echo "" echo "─── DONE ─────────────────────────────────────────────────" echo "" echo "Next steps (one-time):" echo "" echo "1) Edit /opt/buildmymcpserver/docker-compose.prod.yml — add to BOTH" echo " the 'api' and 'generator' services:" echo "" echo " volumes:" echo " - /opt/buildmymcpserver/runner-map:/var/runner-map" echo "" echo "2) Edit /opt/buildmymcpserver/.env.production — add:" echo "" echo " MCP_DOMAIN=mcp.buildmymcpserver.com" echo "" echo "3) Restart api + generator so they pick up the env + volume:" echo "" echo " cd /opt/buildmymcpserver" echo " docker compose --env-file .env.production -f docker-compose.prod.yml \\" echo " up -d --force-recreate api generator" echo "" echo "Test (after at least one runner has been deployed):" echo " curl -I https://.mcp.buildmymcpserver.com/health" echo "" echo "If you ever need to verify the map state:" echo " cat ${COMBINED}" echo " systemctl status bmm-runner-map"