Deploy Bridge ACE in 3 Commands: Docker, VPS, or Local

#docker #devops #selfhosted #deployment

Deploy Bridge ACE in 3 Commands: Docker, VPS, or Local

Bridge ACE runs anywhere Python runs. Here are three deployment options — from local development to production VPS.

Option 1: Local (Development)

git clone https://github.com/Luanace-lab/bridge-ide.git
cd bridge-ide
./install.sh
./Backend/start_platform.sh
# Open http://localhost:9111

The install script handles everything: Python 3.10+ check, tmux installation, pip dependencies, runtime directories. Platform starts HTTP on :9111 and WebSocket on :9112.

Option 2: Docker

git clone https://github.com/Luanace-lab/bridge-ide.git
cd bridge-ide
docker compose up

The Docker setup includes:

Bridge ACE server (Python 3.10-slim + tmux)
Ports: 9111 (HTTP) + 9112 (WebSocket)
Named volumes for persistent state (messages, logs, uploads, agent state)
Health check every 30 seconds
Optional Caddy reverse proxy with --profile remote

Option 3: VPS with Auto-TLS

git clone https://github.com/Luanace-lab/bridge-ide.git
cd bridge-ide
./Backend/deploy_server.sh your-domain.com

One command. Caddy handles HTTPS automatically via Let's Encrypt. WebSocket upgrade is configured. Access your AI team from anywhere.

Architecture: Agents Local, Server Anywhere

The recommended setup for teams:

Server runs on a VPS (always accessible, auto-TLS)
Agents run on your local machine (where your code lives)
Agents connect to the server via WebSocket
You access the UI from any browser

This gives you the best of both: local filesystem access for agents, remote accessibility for the management UI.

Environment Variables

PORT=9111              # HTTP server port
WS_PORT=9112           # WebSocket server port
N8N_BASE_URL=...       # Optional: n8n integration
TWILIO_ACCOUNT_SID=... # Optional: phone integration
ELEVENLABS_API_KEY=... # Optional: voice synthesis