Use the checked-in runtime configuration and deployment runbooks for the environment being operated. The ATLAS_ prefix remains for compatibility. Hosted production uses render.yaml and server-side secret configuration. An unset optional value is different from a fabricated credential. Keep real secrets out of source, public-site files, client bundles, and logs.
| Variable | Purpose |
|---|---|
| ATLAS_AUTH_PROVIDER | clerk for hosted identity; local only for isolated development |
| NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Public web build key for the chosen Clerk application |
| CLERK_SECRET_KEY | Server-only identity credential |
| ATLAS_PUBLIC_ORIGIN | Exact browser-facing application origin |
| CLERK_AUTHORIZED_PARTIES | Comma-separated exact allowed browser origins |
| ATLAS_SECURE_COOKIES | Enable secure cookies for HTTPS deployment |
| DATABASE_URL | Restricted PostgreSQL runtime connection; unset selects SQLite |
| DATABASE_POOL_SIZE | Connection pool size per runtime process |
| ATLAS_DATA_DIR | Private persistent file root; local default .atlas |
| ATLAS_WORKER_MODE | external delegates background work to supervised workers |
| OPENAI_API_KEY | Server credential for AI and semantic indexing |
| OPENAI_MODEL | Provider model for AI requests |
| ATLAS_SEMANTIC_SEARCH | false disables semantic queries and indexing, retaining keyword search |
| ATLAS_EMAIL_ENCRYPTION_KEY | Stable base64-encoded 32-byte email credential encryption key |
| MICROSOFT_CLIENT_ID / MICROSOFT_CLIENT_SECRET | Microsoft confidential OAuth application credentials |
| MICROSOFT_TENANT_ID | Microsoft tenant selection; defaults to common |
| MICROSOFT_REDIRECT_URI | Exact Microsoft callback URI |
| GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET | Google OAuth Web client credentials |
| GOOGLE_REDIRECT_URI | Exact Google callback URI |
| RALTI_DATABASE_ADMIN_URL | Maintenance only: migrations, provisioning, import, backup |
| RALTI_DATA_PATH | Compose host path for persistent private data |
| RALTI_IMAGE_TAG / RALTI_HTTP_PORT | Compose release image tag and loopback host port |
| ATLAS_FILE_STORAGE_DRIVER | local for private development storage; supabase for the configured private shared storage driver |
| ATLAS_SUPABASE_STORAGE_BUCKET | Private shared attachment bucket; the same value on web and workers |
| SUPABASE_URL / SUPABASE_SERVICE_ROLE_KEY | Server-only storage configuration; never return the key to browsers or model context |
| RALTI_APPS_BUILDER_ENABLED / RALTI_APPS_PUBLIC_ENABLED / RALTI_APPS_AUTHENTICATED_ENABLED / RALTI_APPS_UPLOADS_ENABLED / RALTI_APPS_HUMAN_TASKS_ENABLED | Independent emergency controls: false or0 pauses that capability; otherwise enabled. These do not delete saved work. |
ATLAS_DISABLE_WORKER, ATLAS_DISABLE_AI_WORKER, ATLAS_DISABLE_EMAIL_WORKER, and ATLAS_DISABLE_SEARCH_WORKER control embedded startup. External worker services must be supervised independently with the intended roles. Hosted agents require the agents role. A responsive web server can still leave background jobs queued.
Native configuration#
ATLAS_API_URL selects the reachable application origin for the iOS shell and earlier Android Flutter client. iOS loads the website’s identity configuration and session; CLERK_PUBLISHABLE_KEY remains a public Dart build input for the earlier Android interface. These are client build inputs, not aliases for server environment variables. Never bundle a Clerk secret, database URL, provider API key, or email encryption key.
Reviewed workflow connections#
| Variable | Purpose |
|---|---|
| RALTI_FLOW_CONNECTIONS_JSON | Server-side named HTTPS webhook connections for visual workflows. Configure only approved endpoints and credentials; the client receives connection choices rather than secrets. |
Treat connection headers and credentials as runtime secrets. Preview does not send a webhook. Live connector effects follow the workflow’s review and approval requirements; ambiguous delivery is not automatically repeated.