Self-HostingEnvironment Variables

Environment Variables

Complete reference for all HeySummon configuration variables.

Required

VariableDescription
DATABASE_URLDatabase connection string. SQLite: file:./dev.db, PostgreSQL: postgresql://user:pass@host:5432/hitlaas
NEXTAUTH_URLPublic URL of your instance (e.g., https://hitlaas.yourdomain.com)
NEXTAUTH_SECRETRandom secret for session encryption (min 32 chars)

OAuth (Optional)

VariableDescription
AUTH_GITHUB_IDGitHub OAuth App client ID
AUTH_GITHUB_SECRETGitHub OAuth App client secret
AUTH_GOOGLE_IDGoogle OAuth client ID
AUTH_GOOGLE_SECRETGoogle OAuth client secret

At least one OAuth provider should be configured for dashboard access.

Connectivity (Optional)

VariableWhenDescription
CONNECTIVITY_METHODAlwayscloudflare, tailscale, ngrok, or direct
CLOUDFLARE_TUNNEL_TOKENCloudflareTunnel token from dashboard
TAILSCALE_AUTHKEYTailscaleReusable auth key
NGROK_AUTHTOKENNgrokAuth token from ngrok dashboard
NGROK_DOMAINNgrokCustom domain (paid plans)

Example .env.local

DATABASE_URL="file:./dev.db"
NEXTAUTH_SECRET="your-random-secret-at-least-32-chars"
NEXTAUTH_URL="http://localhost:3000"

# GitHub OAuth
AUTH_GITHUB_ID="your-github-client-id"
AUTH_GITHUB_SECRET="your-github-client-secret"

# Google OAuth
AUTH_GOOGLE_ID="your-google-client-id"
AUTH_GOOGLE_SECRET="your-google-client-secret"