Environment Variables

LaunchFast uses environment variables for secrets and configuration. This page lists every variable the template reads, where it is required, and how to set it.

Setting variables

For local development, copy .env.example to .env and fill in the values. Never commit .env to version control.

cp .env.example .env

For production on Fly.io, use fly secrets set for runtime secrets and Docker build arguments for build-time values.

Core

VariableRequiredDescription
SESSION_SECRETYesSigns session cookies. Generate with openssl rand -hex 16.
HONEYPOT_SECRETYesSigns honeypot form fields for spam protection.
INTERNAL_COMMAND_TOKENYesAuthorizes internal admin commands (cache management, health checks).
ALLOW_INDEXINGNoSet to "true" to allow search engine indexing. Defaults to disallowed.

Authentication

VariableRequiredDescription
GITHUB_CLIENT_IDNoGitHub OAuth app client ID. Prefix with MOCK_ for development mocks.
GITHUB_CLIENT_SECRETNoGitHub OAuth app client secret.

Email

VariableRequiredDescription
RESEND_API_KEYProductionResend API key for sending emails. In development, emails are logged to the terminal instead.

Payments

VariableRequiredDescription
STRIPE_ENABLEDNoSet to "true" to enable Stripe integration. All payment behavior is gated behind this flag.
STRIPE_SECRET_KEYIf Stripe enabledStripe secret key from the Stripe Dashboard.
STRIPE_WEBHOOK_ENDPOINTIf Stripe enabledWebhook signing secret from Stripe.

Monitoring

VariableRequiredDescription
SENTRY_DSNNoSentry Data Source Name (runtime). Set via fly secrets.
SENTRY_AUTH_TOKENNoSentry auth token (build-time). Used by the Vite plugin for source maps and releases.
SENTRY_ORGNoSentry organization slug (build-time).
SENTRY_PROJECTNoSentry project slug (build-time).

Deployment

VariableRequiredDescription
LITEFS_CLOUD_TOKENNoLiteFS Cloud token for point-in-time database backups. Set via fly secrets.

Related

  • Manual setup — step-by-step guide including env configuration
  • Email — Resend setup and configuration
  • Sentry — monitoring setup details
  • Stripe — payment integration setup