Text of github.github.com › gh-aw › reference › compiler-enterprise-environment-controls as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Compiler Enterprise Environment Controls | GitHub Agentic Workflows

Skip to main content Compiler Enterprise Environment Controls Use these variables to set organization- or repository-wide defaults and compiler policy without editing individual workflow frontmatter files. In this enterprise controls reference, OTLP defaults are the scope-sensitive exception: GH_AW_DEFAULT_OTLP_ENDPOINT can be a GitHub Actions variable at repository, organization, or enterprise scope, but the GH_AW_DEFAULT_OTLP_ENDPOINT and GH_AW_DEFAULT_OTLP_HEADERS secrets are limited to repository or organization scope.

Enterprise Control Variables Section titled “Enterprise Control Variables” Variable Source Purpose Applies when GH_AW_DEFAULT_ARTIFACT_RETENTION_DAYS GitHub Actions vars.* at runtime Retention period for all gh-aw artifacts artifact_retention_days is not set in .github/workflows/aw.json GH_AW_DEFAULT_MAX_AI_CREDITS GitHub Actions vars.* at runtime Default AWF apiProxy.maxAiCredits budget max-ai-credits is not set in frontmatter or any imported workflow GH_AW_DEFAULT_MAX_TURN_CACHE_MISSES Compiler process environment Default AWF apiProxy.maxCacheMisses guardrail max-turn-cache-misses is not set in frontmatter or any imported workflow GH_AW_DEFAULT_DETECTION_MAX_AI_CREDITS GitHub Actions vars.* at runtime Default threat-detection AWF apiProxy.maxAiCredits budget safe-outputs.threat-detection.max-ai-credits is not set GH_AW_DEFAULT_MAX_DAILY_AI_CREDITS GitHub Actions vars.* at runtime Default max-daily-ai-credits guardrail threshold max-daily-ai-credits is not set in frontmatter or any imported workflow GH_AW_DEFAULT_ADMISSION_URL GitHub Actions repository/organization vars.* at runtime HTTPS /api/admission endpoint; empty skips both admission steps Emitted when admission code generation is enabled at compile time GH_AW_DEFAULT_ADMISSION_AUDIENCE GitHub Actions repository/organization vars.* at runtime Admission OIDC audience Defaults to the effective admission endpoint GH_AW_DEFAULT_ADMISSION_ON_OUTAGE GitHub Actions repository/organization vars.* at runtime Admission outage policy, ignore or block Defaults to ignore ; only transient failures can fail open GH_AW_DEFAULT_SAFE_OUTPUT_AUTHORIZATION_URL GitHub Actions repository/organization vars.* at runtime HTTPS safe-output authority endpoint safe_output_authorization: true in aw.json ; empty blocks live outputs GH_AW_DEFAULT_SAFE_OUTPUT_AUTHORIZATION_AUDIENCE GitHub Actions repository/organization vars.* at runtime Required safe-output authority OIDC audience safe_output_authorization: true in aw.json ; empty blocks live outputs GH_AW_DEFAULT_MAX_TURNS Compiler process environment Default top-level max-turns max-turns is not set in frontmatter and the selected engine supports max-turns GH_AW_DEFAULT_TIMEOUT_MINUTES GitHub Actions vars.* at runtime Default agentic_execution step timeout-minutes (20 minutes) timeout-minutes is not set in frontmatter GH_AW_DEFAULT_AGENT_JOB_TIMEOUT_MINUTES GitHub Actions vars.* at runtime Default generated agent job timeout-minutes (60 minutes) jobs.agent.timeout-minutes is not set in frontmatter GH_AW_DEFAULT_DETECTION_JOB_TIMEOUT_MINUTES GitHub Actions vars.* at runtime Default generated detection job timeout-minutes (10 minutes) jobs.detection.timeout-minutes is not set in frontmatter GH_AW_DEFAULT_DETECTION_MODEL Compiler process environment Default threat-detection model safe-outputs.threat-detection.engine.model is not set GH_AW_DEFAULT_UTC Compiler process environment Default project home UTC offset for rendered CLI timestamps utc is not set in .github/workflows/aw.json GH_AW_DEFAULT_MODEL_COPILOT GitHub Actions vars.* at runtime Default fallback model for Copilot GH_AW_MODEL_AGENT_COPILOT / GH_AW_MODEL_DETECTION_COPILOT is unset GH_AW_DEFAULT_MODEL_CLAUDE GitHub Actions vars.* at runtime Default fallback model for Claude GH_AW_MODEL_AGENT_CLAUDE / GH_AW_MODEL_DETECTION_CLAUDE is unset GH_AW_DEFAULT_MODEL_CODEX GitHub Actions vars.* at runtime Default fallback model for Codex GH_AW_MODEL_AGENT_CODEX / GH_AW_MODEL_DETECTION_CODEX is unset GH_AW_DEFAULT_OTLP_ENDPOINT GitHub Actions secrets.* or vars.* at runtime Default OTLP exporter endpoint observability.otlp.endpoint is not set in frontmatter or any imported workflow GH_AW_DEFAULT_OTLP_HEADERS GitHub Actions secrets.* at runtime Default OTLP exporter headers for GH_AW_DEFAULT_OTLP_ENDPOINT observability.otlp.endpoint is not set in frontmatter or any imported workflow OTEL_EXPORTER_OTLP_PROTOCOL GitHub Actions vars.* at runtime OTLP/HTTP encoding, http/json or http/protobuf Workflow env does not explicitly define the variable; JavaScript traces-specific protocol takes precedence GH_AW_OTEL_METRICS GitHub Actions vars.* at runtime Enable OTLP metrics ( true , the default) or disable them ( false ) Workflow env does not explicitly define the variable GH_AW_OTLP_LOGS_ENABLED GitHub Actions vars.* at runtime Opt in to compact unified-session OTLP logs ( true ); unset or false disables export The conclusion job has a published unified session and configured OTLP endpoints GH_AW_OTLP_LOGS_MAX_BYTES GitHub Actions vars.* at runtime Maximum serialized OTLP session-log request size in bytes (default 65536 ) Session-log export is enabled GH_AW_REQUIRE_SELF_HOSTED_RUNNERS Compiler process environment Fail compilation unless every generated job selects a self-hosted runner Set to true in a trusted compile environment to enforce self-hosted-only runners Use gh aw env get and gh aw env update to manage GH_AW_DEFAULT_* , OTEL_EXPORTER_OTLP_PROTOCOL , and GH_AW_OTEL_METRICS variables in batch.

These commands operate on GitHub Actions variables and support repo, org, or enterprise scope, so default_otlp_endpoint can still be managed as an enterprise variable. Set OTLP secrets separately with gh secret set ; those secrets are limited to repository or organization scope. The defaults file uses default_ -prefixed keys such as default_max_ai_credits , default_max_turn_cache_misses , default_detection_max_ai_credits , default_max_daily_ai_credits , default_timeout_minutes , default_agent_job_timeout_minutes , default_detection_job_timeout_minutes , default_model_copilot , default_otlp_endpoint , default_otlp_protocol , default_otel_metrics , default_artifact_retention_days , and default_utc .

Set default_otel_metrics: false to disable metrics by default; omit or delete it to restore default-on behavior. For the endpoint, gh aw env update --scope ent writes the GH_AW_DEFAULT_OTLP_ENDPOINT variable, not an endpoint secret. To mask the endpoint value, set GH_AW_DEFAULT_OTLP_ENDPOINT with gh secret set at repository or organization scope instead. GH_AW_DEFAULT_OTLP_HEADERS is always a secret and must also be set with gh secret set at repository or organization scope.

If both endpoint values exist, clearing only one leaves the other effective through the fallback expression; clear both the endpoint secret and variable to disable OTLP export. default_otlp_protocol is the defaults-file key for the standard OTEL_EXPORTER_OTLP_PROTOCOL Actions variable (not a GH_AW_DEFAULT_* variable). It accepts http/json or http/protobuf ; null or omission deletes the variable at the selected scope. Recompile existing workflows to add the runtime variable lookup.

Explicit workflow env takes precedence. See OpenTelemetry for details. GH_AW_REQUIRE_SELF_HOSTED_RUNNERS is a compile-time enforcement setting, not a GH_AW_DEFAULT_* default, and is not managed by gh aw env . The same policy can be enabled persistently with require_self_hosted_runners: true in .github/workflows/aw.json , or for a single invocation with gh aw compile --require-self-hosted-runners . Admission code is omitted by default.

Set "admission": true in .github/workflows/aw.json and recompile to emit both admission steps repository-wide without changing activation or conclusion job permissions. An explicit repository setting overrides workflow-level on.admission . Admission defaults use default_admission_url , default_admission_audience , and default_admission_on_outage

The rest of this page is on the live site.