Overview
Environment variables
This reference lists environment variables that you can set directly, that Depot tools read, or that Depot runtime environments provide to your jobs.
It does not include Depot service-internal variables or CI provider runtime variables that Depot tools consume automatically.
Authentication and identity
| Variable | Products | Description |
|---|---|---|
DEPOT_TOKEN | CLI, Container Builds, Depot CI, Depot Cache, Depot Registry, Remote Agents, API/SDK | Depot auth token. The CLI reads this after explicit --token flags and before locally stored login credentials. In Depot CI, Depot injects a short-lived job token automatically. |
DEPOT_CACHE_TOKEN | Depot Cache, Depot CI, GitHub Actions runners | Short-lived Depot Cache auth token. In Depot CI jobs and Depot GitHub Actions runner jobs, Depot injects it automatically. The CLI can also read it as a fallback auth token. |
DEPOT_ORG_ID | Depot Cache, Depot CI, GitHub Actions runners, Remote Agents | Depot organization ID. Cache integrations use it as organization context; Depot CI and GitHub Actions runners set it for jobs automatically. |
Project and build selection
| Variable | Products | Description |
|---|