NameRequiredDefaultDescription
Required settings
TRIGGER_API_URLYes—Trigger.dev API URL. Should point at the webapp.
TRIGGER_WORKER_TOKENYes—Worker token (can be a file path with file://).
MANAGED_WORKER_SECRETYes—Managed worker secret. Needs to match webapp value.
OTEL_EXPORTER_OTLP_ENDPOINTYes—OTel exporter endpoint. Point at: <webapp-url>/otel
Worker instance
TRIGGER_WORKER_INSTANCE_NAMENorandom UUIDWorker instance name. Set to spec.nodeName on k8s.
TRIGGER_WORKER_HEARTBEAT_INTERVAL_SECONDSNo30Worker heartbeat interval (seconds).
Workload API settings
TRIGGER_WORKLOAD_API_ENABLEDNotrueEnable workload API. Runs use this to perform actions.
TRIGGER_WORKLOAD_API_PROTOCOLNohttpWorkload API protocol (http/https).
TRIGGER_WORKLOAD_API_DOMAINNo—Workload API domain. Keep empty for auto-detection.
TRIGGER_WORKLOAD_API_HOST_INTERNALNo0.0.0.0Workload API internal host.
TRIGGER_WORKLOAD_API_PORT_INTERNALNo8020Workload API internal port.
TRIGGER_WORKLOAD_API_PORT_EXTERNALNo8020Workload API external port.
Runner settings
RUNNER_HEARTBEAT_INTERVAL_SECONDSNo—Runner heartbeat interval (seconds).
RUNNER_SNAPSHOT_POLL_INTERVAL_SECONDSNo—Runner snapshot poll interval (seconds).
RUNNER_ADDITIONAL_ENV_VARSNo—Additional runner env vars (CSV).
RUNNER_PRETTY_LOGSNofalsePretty logs for runner.
Dequeue settings
TRIGGER_DEQUEUE_ENABLEDNotrueEnable dequeue to pull runs from the queue.
TRIGGER_DEQUEUE_INTERVAL_MSNo250Dequeue interval (ms).
TRIGGER_DEQUEUE_IDLE_INTERVAL_MSNo1000 (1s)Dequeue idle interval (ms).
TRIGGER_DEQUEUE_MAX_RUN_COUNTNo10Max dequeue run count.
TRIGGER_DEQUEUE_MAX_CONSUMER_COUNTNo1Max dequeue consumer count.
Docker settings
DOCKER_API_VERSIONNov1.41Docker API version. You should probably not touch this.
DOCKER_STRIP_IMAGE_DIGESTNotrueStrip image digest in Docker. Turning off can cause issues.
DOCKER_ENFORCE_MACHINE_PRESETSNotrueEnforce Docker machine cpu and memory limits.
DOCKER_AUTOREMOVE_EXITED_CONTAINERSNotrueAuto-remove exited containers.
DOCKER_RUNNER_NETWORKSNohostDocker runner networks (CSV).
Registry auth
DOCKER_REGISTRY_URLNo—Docker registry URL, e.g. docker.io.
DOCKER_REGISTRY_USERNAMENo—Docker registry username.
DOCKER_REGISTRY_PASSWORDNo—Docker registry password.
Kubernetes settings
KUBERNETES_FORCE_ENABLEDNofalseForce Kubernetes mode.
KUBERNETES_NAMESPACENodefaultThe namespace that runs should be in.
KUBERNETES_WORKER_NODETYPE_LABELNov4-workerNodes for runs need this label, e.g. nodetype=v4-worker.
KUBERNETES_IMAGE_PULL_SECRETSNo—Image pull secrets (CSV).
KUBERNETES_EPHEMERAL_STORAGE_SIZE_LIMITNo10GiEphemeral storage size limit. Applies to all runs.
KUBERNETES_EPHEMERAL_STORAGE_SIZE_REQUESTNo2GiEphemeral storage size request. Applies to all runs.
Metrics
METRICS_ENABLEDNotrueEnable metrics.
METRICS_COLLECT_DEFAULTSNotrueCollect default metrics.
METRICS_HOSTNo127.0.0.1Metrics host.
METRICS_PORTNo9090Metrics port.
Pod cleaner
POD_CLEANER_ENABLEDNotrueEnable pod cleaner.
POD_CLEANER_INTERVAL_MSNo10000 (10s)Pod cleaner interval (ms). Best not to touch this.
POD_CLEANER_BATCH_SIZENo500Pod cleaner batch size.
Failed pod handler
FAILED_POD_HANDLER_ENABLEDNotrueEnable failed pod handler.
FAILED_POD_HANDLER_RECONNECT_INTERVAL_MSNo1000 (1s)Failed pod handler reconnect interval (ms).
Debug
DEBUGNofalseEnable debug logs.
SEND_RUN_DEBUG_LOGSNofalseSend run debug logs to the platform.
Not used for self-hosting
TRIGGER_WARM_START_URLNo—Warm start URL.
TRIGGER_CHECKPOINT_URLNo—Checkpoint URL.
TRIGGER_METADATA_URLNo—Metadata URL.
RESOURCE_MONITOR_ENABLEDNofalseEnable resource monitor.
RESOURCE_MONITOR_OVERRIDE_CPU_TOTALNo—Override CPU total for resource monitor.
RESOURCE_MONITOR_OVERRIDE_MEMORY_TOTAL_GBNo—Override memory total (GB) for resource monitor.