Environment variables

Every variable a self-hosted install reads, with its default and what it controls.

These apply to self-hosted installs. Flowblocks Cloud manages them for you.

Core

Variable	Default	What it does
`DATABASE_URL`		Postgres connection string
`BETTER_AUTH_SECRET`		Session signing secret
`BETTER_AUTH_URL`	`http://localhost:3000`	Public origin used to build OAuth redirect URIs
`NEXT_PUBLIC_APP_URL`	`http://localhost:3000`	Origin shown to the browser
`INTEGRATION_ENCRYPTION_KEY`	derived	64 hex characters. Encrypts connector and MCP tokens at rest

An Agent step uses the key for the provider you pick. The workflow generator uses the same keys.

Variable	Used for
`OPENAI_API_KEY`	OpenAI models, and the workflow generator
`ANTHROPIC_API_KEY`	Anthropic models
`XAI_API_KEY`	xAI models
`AI_GATEWAY_API_KEY`	Any of the models above when that provider's own key is empty, through Vercel AI Gateway
`AGENT_DEMO`	Set to `true` to skip the model entirely

Variable	Connectors
`GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`	Every Google connector
`DROPBOX_CLIENT_ID`, `DROPBOX_CLIENT_SECRET`	Dropbox
`MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`	Every Microsoft connector
`MICROSOFT_TENANT_ID`	Optional. Restricts the Microsoft connectors to one directory
`{PREFIX}_CLIENT_ID`, `{PREFIX}_CLIENT_SECRET`	Each other provider, under the prefix its section names, such as `LINEAR` or `HUBSPOT`
`GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`	Optional. GitHub sign-in. The GitHub connector uses `GITHUB_CONNECTOR_*`

Variable	Default	What it does
`AI_LIMIT_PER_MINUTE`	20	Cap on generate, run and MCP calls per user per minute
`RUN_TOKEN_BUDGET`	200000	Token cap for one run
`MCP_ALLOW_PRIVATE_URLS`	unset	Allow private MCP server URLs in production

Variable	What it does
`LIVEBLOCKS_SECRET_KEY`	Enables live cursors, presence and comments

Optional. With these unset every workspace stays on the free Developer plan.

Variable	What it does
`STRIPE_SECRET_KEY`	A Stripe restricted key. Turns billing on together with the price below
`STRIPE_CLOUD_PRICE_ID`	The metered Cloud price. `pnpm stripe:setup` creates it and prints its id
`STRIPE_WEBHOOK_SECRET`	Signing secret of the webhook endpoint at `/api/stripe/webhook`
`STRIPE_AUTOMATIC_TAX`	Set to `true` once Stripe Tax is set up on the account