Setup overview
You'll do everything once, in this order:
- Supabase — create the database and run the initial migration. Gives you
SUPABASE_URLandSUPABASE_SERVICE_ROLE_KEY. - WorkOS — set up AuthKit and pick your organisation. Gives you
WORKOS_API_KEY,WORKOS_CLIENT_ID,WORKOS_ORGANIZATION_ID, and aWORKOS_COOKIE_PASSWORDyou generate yourself. - E2B — create an API key. Gives you
E2B_API_KEY. - AI providers — at minimum one of OpenAI / Anthropic / Google; optionally Composio.
- Build the E2B template — run
npm run template:buildlocally so sandboxes have something to spawn from. - Environment variables — the full reference, useful when you're pasting into Vercel.
- Deploy to Vercel — push the repo, paste the env vars, click deploy.
After that you can:
- Test locally first with local development.
- Onboard your team via WorkOS.
- Keep an eye on things through the Manage UI.
Two places each variable lives
Every env var goes into two spots:
.env.localon your machine (so the Manage UI and the E2B template build can run).- Vercel → Settings → Environment Variables for production.
The env-vars reference calls out which set each variable belongs to.
A clean setup in an afternoon
If nothing unusual happens, the whole thing — dashboards, keys, template build, first Vercel deploy — is doable in an afternoon. The one time-consuming step is the first npm run template:build, which uploads a multi-GB image to E2B.