Self-HostingSetup Wizard

Setup Wizard

The interactive setup wizard automates self-hosted deployment.

Running the Wizard

git clone https://github.com/thomasansems/hitlaas-platform.git
cd hitlaas-platform
bash scripts/setup.sh

What It Does

  1. Asks which connectivity method — Cloudflare Tunnel, Tailscale Funnel, Ngrok, or Direct
  2. Collects tokens/keys — only for the chosen method
  3. Generates .env — with all required environment variables and a random NEXTAUTH_SECRET
  4. Generates docker-compose.override.yml — adds the tunnel sidecar container
  5. Optionally starts the stack — docker compose up -d

Generated Files

.env

Contains all environment variables:

  • DATABASE_URL — PostgreSQL connection string
  • NEXTAUTH_URL — your public URL
  • NEXTAUTH_SECRET — random 32-char secret
  • OAuth credentials (if provided)
  • Connectivity tokens

docker-compose.override.yml

Adds the tunnel sidecar for your chosen connectivity method.

After Setup

  1. Open your public URL in a browser
  2. Sign in with GitHub or Google
  3. Create an API key in Settings
  4. Share the key with your AI agent consumers
ConnectivityAzure Deployment