Skip to content

Getting started

Configuration

Essential settings for the app, database, authentication, and email.

Configuration

Start with .env.example. Never commit .env, credentials, or SQLite databases.

VariablePurpose
APP_KEYEncryption and signatures; use the same key in web and worker.
APP_URLCanonical dashboard URL and OAuth callback origin.
DATABASE_URLPostgreSQL connection in production.
SOCIAL_GOOGLE_CLIENT_ID / SOCIAL_GOOGLE_CLIENT_SECRETGoogle OAuth Web client.
MAIL_MAILER / RESEND_API_KEYResend delivery when MAIL_MAILER=resend.
QUEUE_CONNECTIONUse database for a persistent queue.

When rotating APP_KEY, keep older keys in APP_PREVIOUS_KEYS while existing sessions and signed links remain valid. Set APP_DEBUG=false in production.