NameRequiredDefaultDescription
Secrets
SESSION_SECRETYes—Session encryption secret. Run: openssl rand -hex 16
MAGIC_LINK_SECRETYes—Magic link encryption secret. Run: openssl rand -hex 16
ENCRYPTION_KEYYes—Secret store encryption key. Run: openssl rand -hex 16
MANAGED_WORKER_SECRETNomanaged-secretManaged worker secret. Should be changed and match supervisor.
Domains & ports
REMIX_APP_PORTNo3030Remix app port.
APP_ORIGINYeshttp://localhost:3030App origin URL.
LOGIN_ORIGINYeshttp://localhost:3030Login origin URL. Most likely the same as APP_ORIGIN.
API_ORIGINNoAPP_ORIGINAPI origin URL.
STREAM_ORIGINNoAPP_ORIGINRealtime stream origin URL.
ELECTRIC_ORIGINNohttp://localhost:3060Electric origin URL.
Postgres
DATABASE_URLYes—PostgreSQL connection string.
DIRECT_URLYes—Direct DB connection string used for migrations etc.
DATABASE_CONNECTION_LIMITNo10Max DB connections.
DATABASE_POOL_TIMEOUTNo60DB pool timeout (s).
DATABASE_CONNECTION_TIMEOUTNo20DB connect timeout (s).
DATABASE_READ_REPLICA_URLNoDATABASE_URLRead-replica DB string.
Redis
REDIS_HOSTYes—Redis host.
REDIS_PORTYes—Redis port.
REDIS_READER_HOSTNoREDIS_HOSTRedis reader host.
REDIS_READER_PORTNoREDIS_PORTRedis reader port.
REDIS_USERNAMENo—Redis username.
REDIS_PASSWORDNo—Redis password.
REDIS_TLS_DISABLEDNo—Disable Redis TLS.
Auth
WHITELISTED_EMAILSNo—Whitelisted emails regex.
AUTH_GITHUB_CLIENT_IDNo—GitHub client ID.
AUTH_GITHUB_CLIENT_SECRETNo—GitHub client secret.
Email
EMAIL_TRANSPORTNo—Email transport type. One of resend, smtp, aws-ses.
FROM_EMAILNo—From email address.
REPLY_TO_EMAILNo—Reply-to email address.
RESEND_API_KEYNo—Resend API key.
SMTP_HOSTNo—SMTP host.
SMTP_PORTNo—SMTP port.
SMTP_SECURENo—SMTP secure flag.
SMTP_USERNo—SMTP user.
SMTP_PASSWORDNo—SMTP password.
AWS_REGIONNo—AWS region for SES.
AWS_ACCESS_KEY_IDNo—AWS access key ID for SES.
AWS_SECRET_ACCESS_KEYNo—AWS secret access key for SES.
Graphile & Redis worker
WORKER_CONCURRENCYNo10Redis worker concurrency.
WORKER_POLL_INTERVALNo1000Redis worker poll interval (ms).
WORKER_SCHEMANographile_workerGraphile worker schema.
GRACEFUL_SHUTDOWN_TIMEOUTNo60000 (1m)Graphile graceful shutdown timeout (ms). Affects shutdown time.
Concurrency limits
DEFAULT_ENV_EXECUTION_CONCURRENCY_LIMITNo100Default env execution concurrency.
DEFAULT_ORG_EXECUTION_CONCURRENCY_LIMITNo300Default org execution concurrency, needs to be 3x env concurrency.
Dev
DEV_MAX_CONCURRENT_RUNSNo25Sets the max concurrency for dev runs via the CLI.
DEV_OTEL_EXPORTER_OTLP_ENDPOINTNoAPP_ORIGIN/otelOTel endpoint for dev runs.
Rate limiting
API_RATE_LIMIT_REFILL_INTERVALNo10sAPI rate limit refill interval.
API_RATE_LIMIT_MAXNo750API rate limit max.
API_RATE_LIMIT_REFILL_RATENo250API rate limit refill rate.
API_RATE_LIMIT_REQUEST_LOGS_ENABLEDNo0API rate limit request logs.
API_RATE_LIMIT_REJECTION_LOGS_ENABLEDNo1API rate limit rejection logs.
API_RATE_LIMIT_LIMITER_LOGS_ENABLEDNo0API rate limit limiter logs.
API_RATE_LIMIT_JWT_WINDOWNo1mAPI rate limit JWT window.
API_RATE_LIMIT_JWT_TOKENSNo60API rate limit JWT tokens.
Deploy & Registry
DEPLOY_REGISTRY_HOSTYes—Deploy registry host.
DEPLOY_REGISTRY_USERNAMENo—Deploy registry username.
DEPLOY_REGISTRY_PASSWORDNo—Deploy registry password.
DEPLOY_REGISTRY_NAMESPACENotriggerDeploy registry namespace.
DEPLOY_IMAGE_PLATFORMNolinux/amd64Deploy image platform, same values as docker --platform flag.
DEPLOY_TIMEOUT_MSNo480000 (8m)Deploy timeout (ms).
Object store (S3)
OBJECT_STORE_BASE_URLNo—Object store base URL.
OBJECT_STORE_ACCESS_KEY_IDNo—Object store access key.
OBJECT_STORE_SECRET_ACCESS_KEYNo—Object store secret key.
OBJECT_STORE_REGIONNo—Object store region.
OBJECT_STORE_SERVICENos3Object store service.
Alerts
ORG_SLACK_INTEGRATION_CLIENT_IDNo—Slack client ID. Required for Slack alerts.
ORG_SLACK_INTEGRATION_CLIENT_SECRETNo—Slack client secret. Required for Slack alerts.
ALERT_EMAIL_TRANSPORTNo—Alert email transport.
ALERT_FROM_EMAILNo—Alert from email.
ALERT_REPLY_TO_EMAILNo—Alert reply-to email.
ALERT_RESEND_API_KEYNo—Alert Resend API key.
ALERT_SMTP_HOSTNo—Alert SMTP host.
ALERT_SMTP_PORTNo—Alert SMTP port.
ALERT_SMTP_SECURENo—Alert SMTP secure.
ALERT_SMTP_USERNo—Alert SMTP user.
ALERT_SMTP_PASSWORDNo—Alert SMTP password.
Limits
TASK_PAYLOAD_OFFLOAD_THRESHOLDNo524288 (512KB)Max task payload size before offloading to S3.
TASK_PAYLOAD_MAXIMUM_SIZENo3145728 (3MB)Max task payload size.
BATCH_TASK_PAYLOAD_MAXIMUM_SIZENo1000000 (1MB)Max batch payload size.
TASK_RUN_METADATA_MAXIMUM_SIZENo262144 (256KB)Max metadata size.
MAX_BATCH_V2_TRIGGER_ITEMSNo500Max batch size.
MAXIMUM_DEV_QUEUE_SIZENo—Max dev queue size.
MAXIMUM_DEPLOYED_QUEUE_SIZENo—Max deployed queue size.
Realtime
REALTIME_STREAM_MAX_LENGTHNo1000Realtime stream max length.
REALTIME_STREAM_TTLNo86400 (1d)Realtime stream TTL (s).
Bootstrap
TRIGGER_BOOTSTRAP_ENABLEDNo0Trigger bootstrap enabled.
TRIGGER_BOOTSTRAP_WORKER_GROUP_NAMENo—Trigger bootstrap worker group name.
TRIGGER_BOOTSTRAP_WORKER_TOKEN_PATHNo—Trigger bootstrap worker token path.
Run engine
RUN_ENGINE_WORKER_COUNTNo4Run engine worker count.
RUN_ENGINE_TASKS_PER_WORKERNo10Run engine tasks per worker.
RUN_ENGINE_WORKER_CONCURRENCY_LIMITNo10Run engine worker concurrency limit.
RUN_ENGINE_WORKER_POLL_INTERVALNo100Run engine worker poll interval (ms).
RUN_ENGINE_WORKER_IMMEDIATE_POLL_INTERVALNo100Run engine worker immediate poll interval (ms).
RUN_ENGINE_WORKER_SHUTDOWN_TIMEOUT_MSNo60000 (1m)Run engine worker shutdown timeout (ms).
RUN_ENGINE_RATE_LIMIT_REFILL_INTERVALNo10sRun engine rate limit refill interval.
RUN_ENGINE_RATE_LIMIT_MAXNo1200Run engine rate limit max.
RUN_ENGINE_RATE_LIMIT_REFILL_RATENo400Run engine rate limit refill rate.
RUN_ENGINE_RATE_LIMIT_REQUEST_LOGS_ENABLEDNo0Run engine rate limit request logs.
RUN_ENGINE_RATE_LIMIT_REJECTION_LOGS_ENABLEDNo1Run engine rate limit rejection logs.
RUN_ENGINE_RATE_LIMIT_LIMITER_LOGS_ENABLEDNo0Run engine rate limit limiter logs.
Misc
TRIGGER_TELEMETRY_DISABLEDNo—Disable telemetry.
NODE_MAX_OLD_SPACE_SIZENo8192Maximum memory allocation for Node.js heap in MiB (e.g. “4096” for 4GB).
OPENAI_API_KEYNo—OpenAI API key.
MACHINE_PRESETS_OVERRIDE_PATHNo—Path to machine presets override file. See machine overrides.
APP_ENVNoNODE_ENVApp environment. Used for things like the title tag.
ADMIN_EMAILSNo—Regex of user emails to automatically promote to admin.
EVENT_LOOP_MONITOR_ENABLEDNo1Node.js event loop lag monitor.