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

VariableProductsDescription
DEPOT_TOKENCLI, Container Builds, Depot CI, Depot Cache, Depot Registry, Remote Agents, API/SDKDepot 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_TOKENDepot Cache, Depot CI, GitHub Actions runnersShort-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_IDDepot Cache, Depot CI, GitHub Actions runners, Remote AgentsDepot organization ID. Cache integrations use it as organization context; Depot CI and GitHub Actions runners set it for jobs automatically.

Project and build selection

VariableProductsDescription