josephmisiti/background-agents

Node.js API

9 environment variables found in packages/web/.env.example

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.

GITHUB_CLIENT_ID GitHub OAuth (create at https://github.com/settings/developers)
GITHUB_CLIENT_SECRET secret
NEXTAUTH_URL NextAuth (generate with: openssl rand -base64 32)
NEXTAUTH_SECRET secret
CONTROL_PLANE_URL Control Plane
NEXT_PUBLIC_WS_URL
INTERNAL_CALLBACK_SECRET secret Control Plane Authentication (must match control plane's INTERNAL_CALLBACK_SECRET) Generate with: openssl rand -base64 32
ALLOWED_EMAIL_DOMAINS Access Control (comma-separated, leave empty to allow all GitHub users)
ALLOWED_USERS

Alternative Fly.io Anything Dockerized — requires the Fly CLI.

macOS

brew install flyctl && fly launch --from https://github.com/josephmisiti/background-agents

Linux

curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/josephmisiti/background-agents

Windows (PowerShell)

iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/josephmisiti/background-agents

Or deploy to a different host