{"name":"SELF_HOSTED_RUNNER_SERVER_AUTO_MODE_LISTS","slug":"self-hosted-runner-server-auto-mode-lists","family":"env","title":"Environment variables","noun":"environment variable","description":"A new `SELF_HOSTED_RUNNER_SERVER_AUTO_MODE_LISTS` setting lets self-hosted runner operators limit which server-supplied auto mode lists sessions follow","description_source":"entry","described_by":{"version":"2.1.295","anchor":"self-hosted-runner-new-self-hosted-runner-server-auto-mode"},"presence":{"first_seen":"2.1.295","removed_in":null,"in_current_build":true,"newest_mined":"2.1.295","builds":1,"mined_builds":138,"first_cited":{"version":"2.1.295","released_at":"2026-10-08 18:22:58","spans":1}},"aliases":[],"entries":[{"version":"2.1.295","anchor":"self-hosted-runner-new-self-hosted-runner-server-auto-mode","heading":"Self-hosted runners can choose which server auto mode lists apply","line":"A new `SELF_HOSTED_RUNNER_SERVER_AUTO_MODE_LISTS` setting lets self-hosted runner operators limit which server-supplied auto mode lists sessions follow","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text, named in this entry"}],"entries_total":1,"docs":[],"docs_total":0,"gates":[],"related":[{"name":"SELF_HOSTED_RUNNER_BASE_DIR","slug":"self-hosted-runner-base-dir","description":"The self-hosted runner fails fast if its base directory is unwritable or the mount hangs."},{"name":"SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS","slug":"self-hosted-runner-bg-result-grace-ms","description":"Self-hosted runners hold shutdown until a finished background task is read; the grace window is configurable."},{"name":"SELF_HOSTED_RUNNER_CLIENT_LABEL","slug":"self-hosted-runner-client-label","description":"Name a self-hosted runner with --client-label or an env var instead of using the hostname."},{"name":"SELF_HOSTED_RUNNER_CONFIGURE_GIT","slug":"self-hosted-runner-configure-git","description":"A truthy value (`1`, `true`, `yes`, `on`) turns on `--configure-git` for `claude self-hosted-runner`: at startup the runner writes global git config setting `user.name` to `Claude`, `user.email` to `noreply@anthropic.com`, SSH signing of commits and tags through a `code-sign` shim under `<base-dir>\/.runner\/`, and `push.negotiate`. A failure there is fatal; the setting also makes commits made by lifecycle hooks signed per session."},{"name":"SELF_HOSTED_RUNNER_CONFINE_REPO_SETTINGS","slug":"self-hosted-runner-confine-repo-settings","description":"The runner can warn about or block repo-committed settings that grant access outside the workspace."},{"name":"SELF_HOSTED_RUNNER_DEBUG_DIR","slug":"self-hosted-runner-debug-dir","description":"Directory for debug artifacts of the `claude self-hosted-runner` orchestrator: after each spawn-runner hook run it writes `<jti>.jwt`, `<jti>.json` (the decoded work-order claims) and `<jti>.stderr` (the hook's stderr or failure message) with mode `0600`, and deletes matching files older than 5 minutes. The directory is created at startup; if that fails the orchestrator continues without debug artifacts."},{"name":"SELF_HOSTED_RUNNER_DEBUG_TOKEN_DIR","slug":"self-hosted-runner-debug-token-dir","description":"Directory where `claude self-hosted-runner` writes live credentials for debugging: `runner_token.jwt` at registration and on each refresh, and per session `session_token_<id>.jwt` and `inference_token_<id>.txt`. The directory is created with mode `0700` and the files with mode `0600`; write failures are logged and ignored. `--debug-token-dir` sets the same option."},{"name":"SELF_HOSTED_RUNNER_DEFER_SHUTDOWN_MAX_MS","slug":"self-hosted-runner-defer-shutdown-max-ms","description":"Self-hosted runners can keep serving attached sessions on the first shutdown signal instead of draining."},{"name":"SELF_HOSTED_RUNNER_DRAIN_GRACE_MS","slug":"self-hosted-runner-drain-grace-ms","description":"Milliseconds `claude self-hosted-runner` keeps polling after the work it was assigned has drained (no sessions running and none pending) before it exits. Default `0`, which exits as soon as the workload drains; an unset, non-numeric or non-positive value counts as `0`, and `--drain-grace-sec` sets it. A positive value also turns off `CLAUDE_RUNNER_TRUST_CANONICAL_PREWARM`: with `--use-anthropic-git-proxy` the combination is a fatal startup error, and otherwise the runner logs that the prewarm is ignored and sanitizes the canonical checkout anyway."},{"name":"SELF_HOSTED_RUNNER_DRAIN_MARKER_FILE","slug":"self-hosted-runner-drain-marker-file","description":"The self-hosted runner can now snapshot an operator's Claude config and seed it into every session, with a drain-marker mechanism"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/env\/self-hosted-runner-server-auto-mode-lists","family_url":"https:\/\/changelogs.core-directive.com\/reference\/env.json"}