Hotspot can be deployed anywhere Docker runs: AWS EC2, DigitalOcean, Hetzner, GCP, or on-premises servers.
1. docker-compose.yml
Save this file as docker-compose.yml on your server:
YAML
services:
hotspot:
image: hotspot:latest
build:
context: .
dockerfile: products/hotspot/standalone/Dockerfile
ports:
- "127.0.0.1:8000:8000"
env_file:
- .env
depends_on:
redis:
condition: service_healthy
restart: unless-stopped
redis:
image: redis:7-alpine
command: ["redis-server", "--appendonly", "yes"]
volumes:
- hotspot-redis:/data
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 5s
timeout: 3s
retries: 5
restart: unless-stopped
volumes:
hotspot-redis:
2. Environment Variables (.env)
| Variable | Required | Default / Description |
|---|---|---|
HOTSPOT_SITE_URL |
Yes | Public URL (e.g. https://hotspot.buxa.ai). |
HOTSPOT_DASHBOARD_PASSWORD |
Recommended | Master password to protect dashboard login. |
HOTSPOT_SECRET_KEY |
Yes | Server secret key used for session cookie signing and MCP auth. |
REDIS_URL |
Recommended | Connection string (e.g. redis://redis:6379/0). Uses in-memory storage if unset. |
HOTSPOT_REPLAY_ENABLED |
Optional | Set to 1 to enable session recording. |
HOTSPOT_DEMO_ENABLED |
Optional | Set to 1 to expose the interactive sample site at /demo/. |
3. Start the Stack
docker compose up -d --build
Your Hotspot server is now live on port 8000. Set up a reverse proxy (such as Caddy or Nginx) with an SSL certificate to serve over HTTPS.