Environment variables that configure Azure Developer CLI behavior. These can be set in your shell, CI/CD pipeline, or .env files.
| Variable | Description |
|---|
AZD_ALPHA_ENABLE_<NAME> | Enable a specific alpha feature |
| Variable | Description |
|---|
AZD_CONFIG_DIR | Override the default user configuration directory |
AZURE_DEV_COLLECT_TELEMETRY | Set to no to disable telemetry collection |
| Variable | Description |
|---|
AZD_DEMO_MODE | When set, hides PII (e.g., subscription IDs) in output |
AZD_FORCE_TTY | Force terminal detection mode (true forces TTY mode, false forces non-TTY mode) |
AZD_IN_CLOUDSHELL | Indicates azd is running in Azure Cloud Shell |
AZD_SKIP_UPDATE_CHECK | Skip the periodic update availability check |
AZD_DEBUG_LOG | Enable debug file logging |
Override the path to external tools that azd invokes:
| Variable | Description |
|---|
AZD_BICEP_TOOL_PATH | Path to the Bicep CLI binary |
AZD_GH_TOOL_PATH | Path to the GitHub CLI binary |
AZD_PACK_TOOL_PATH | Path to the Cloud Native Buildpacks (pack) binary |
| Variable | Description |
|---|
AZD_BUILDER_IMAGE | Builder image for Dockerfile-less container builds |
| Variable | Description |
|---|
AZD_DEPLOYMENT_ID_FILE | Absolute path to a file where azd writes ARM deployment resource IDs in NDJSON format (one JSON line per layer) during Bicep provisioning. The file is truncated at the start of each run; each layer appends {"deploymentId":"...","layer":"<name>"}. Enables external tooling (e.g., VS Code extension) to track all in-flight deployments without scraping console output. See cli/azd/docs/environment-variables.md for the full contract. |
Set by IDE hosts (VS Code, Visual Studio) when spawning azd as a subprocess. Users do not set these manually.
| Variable | Description |
|---|
AZD_AUTH_ENDPOINT | Authentication endpoint URL set by IDE hosts for integrated authentication |
AZD_AUTH_KEY | Authentication key set by IDE hosts for integrated authentication |
AZD_AUTH_CERT | Authentication certificate/TLS trust configuration set by IDE hosts |
For details on the external authentication protocol, see cli/azd/docs/external-authentication.md.
For the full reference with implementation details, see cli/azd/docs/environment-variables.md.