omnipaper

Environment variables

The full reference for every environment variable the app reads at boot.

Environment variables cover deploy time wiring and secrets. Everything else (storage, OCR, AI, email) is configured in the UI. See Installation for the minimal set.

Required

VariableDescription
DATABASE_URLPostgreSQL connection string.
AUTH_SECRETSigns auth sessions and cookies. Use a random 32 byte value (openssl rand -base64 32).
ENCRYPTION_KEYEncrypts credentials you store in the app (S3, OCR, AI, email passwords). Minimum 16 characters. Generate with openssl rand -base64 32. Keep it stable and backed up: if you change or lose it, stored secrets can no longer be decrypted and must be re entered in Settings.

Networking

VariableDefaultDescription
APP_URLderived from requestPublic URL of your instance. See Installation.
EXTRA_TRUSTED_ORIGINSComma separated extra origins for CORS and auth.
PORT3000Port the app listens on inside the container.

On this page