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.

VariablePurpose
ATLAS_AUTH_PROVIDERclerk for hosted identity; local only for isolated development
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYPublic web build key for the chosen Clerk application
CLERK_SECRET_KEYServer-only identity credential
ATLAS_PUBLIC_ORIGINExact browser-facing application origin
CLERK_AUTHORIZED_PARTIESComma-separated exact allowed browser origins
ATLAS_SECURE_COOKIESEnable secure cookies for HTTPS deployment
DATABASE_URLRestricted PostgreSQL runtime connection; unset selects SQLite
DATABASE_POOL_SIZEConnection pool size per runtime process
ATLAS_DATA_DIRPrivate persistent file root; local default .atlas
ATLAS_WORKER_MODEexternal delegates background work to supervised workers
OPENAI_API_KEYServer credential for AI and semantic indexing
OPENAI_MODELProvider model for AI requests
ATLAS_SEMANTIC_SEARCHfalse disables semantic queries and indexing, retaining keyword search
ATLAS_EMAIL_ENCRYPTION_KEYStable base64-encoded 32-byte email credential encryption key
MICROSOFT_CLIENT_ID / MICROSOFT_CLIENT_SECRETMicrosoft confidential OAuth application credentials
MICROSOFT_TENANT_IDMicrosoft tenant selection; defaults to common
MICROSOFT_REDIRECT_URIExact Microsoft callback URI
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRETGoogle OAuth Web client credentials
GOOGLE_REDIRECT_URIExact Google callback URI
RALTI_DATABASE_ADMIN_URLMaintenance only: migrations, provisioning, import, backup
RALTI_DATA_PATHCompose host path for persistent private data
RALTI_IMAGE_TAG / RALTI_HTTP_PORTCompose release image tag and loopback host port
ATLAS_FILE_STORAGE_DRIVERlocal for private development storage; supabase for the configured private shared storage driver
ATLAS_SUPABASE_STORAGE_BUCKETPrivate shared attachment bucket; the same value on web and workers
SUPABASE_URL / SUPABASE_SERVICE_ROLE_KEYServer-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_ENABLEDIndependent 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#

VariablePurpose
RALTI_FLOW_CONNECTIONS_JSONServer-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.