H tspot Docs
Hotspot › Docs › AI & Self-Hosting › Self-Hosting & Docker

Self-Hosting, Docker & Production Ops

Deploy Hotspot on your own VPS or Kubernetes cluster with Docker Compose, Redis persistence, and Caddy/Nginx reverse proxy.

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.