Self-Hosting & Deployment

Cloud Harness MCP is designed for straightforward self-hosting on any modern Linux VPS or cloud instance.

Deployment Architectures

1. 1-Click Automated Deployment (Caddy / Cloudflare Tunnel)

For a modern, zero-fuss self-hosted deployment on standard Linux (Ubuntu 24.04 LTS):

# Single-command install with Let's Encrypt TLS (Caddy)
curl -fsSL https://raw.githubusercontent.com/bestagentkits/cloud-harness-mcp/main/scripts/install.sh | sudo bash

• Caddy Ingress: Automatically requests and renews Let's Encrypt TLS certificates, proxying traffic to the loopback ingress 127.0.0.1:3100.
• Cloudflare Tunnel: Connects cloudflared directly to the ingress network, exposing zero host listening ports.
• Management: Uses the cloudharness CLI (cloudharness status, cloudharness logs, cloudharness token).

2. Traditional NGINX Reverse Proxy Runbook

For custom infrastructure with existing NGINX setups:

1. Bootstrap VPS: Run deploy/scripts/bootstrap-vps.sh to install Docker, systemd unit, and permissions.
2. Deploy Release: Run deploy/scripts/deploy-release.sh <git-sha> to build and start production containers.
3. Canary Verification: Run scripts/deploy-canary.mjs to execute an automated end-to-end workspace test against the newly deployed instance.