How-to Guides
Self-host one command
Bootstrap a local FluxyChat stack with wrangler D1 migrations and dev env files.
Self-host in one command
pnpm run self-host copies env templates, then asks for a Groq key if the terminal is interactive. It also writes API_KEY_HASH_SALT if missing. Agent model on Groq: openai/gpt-oss-20b.
pnpm run self-hostThen start services:
# Terminal 1 — Worker API + WebSocket
pnpm --filter @fluxy-chat/worker dev
# Terminal 2 — Dashboard console (optional)
pnpm --filter dashboard devVerify with:
pnpm run first-messageWhat the script does
pnpm install(if needed)pnpm run dev:setup— createsapps/worker/.dev.varsandapps/dashboard/.env.localfrom templateswrangler d1 migrations apply fluxychat --local— schema + seed data (includingbuiltin_agent_templates)
Production deploy
For remote Cloudflare deploy, see Local development and Production setup:
cd apps/worker
pnpm exec wrangler d1 migrations apply fluxychat --remote
pnpm run deploySet secrets via wrangler secret put (JWT signing keys, LLM provider keys, webhook HMAC secrets).
Related
- Client setup — SDK integration
- Auth JWT — mint member tokens