Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.238 ·

Self-hosted runner can defer its drain on the first shutdown signal

Self-hosted runners can keep serving attached sessions on the first shutdown signal instead of draining.

Use it now Notable New Features
JSON All of v2.1.238
Use it nowTier: how much it should matter to you
2Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Self-Hosted RunnerArea: what it touches
New FeaturesKind: in v2.1.238,
What probably matters to youSection of the release
What

New flag --defer-shutdown-max-min <m> makes the first SIGTERM stop the runner accepting new work while it keeps serving attached sessions, rather than starting the drain budget straight away. It writes SELF_HOSTED_RUNNER_DEFER_SHUTDOWN_MAX_MS; 0 disables it and is the default, so operators who do not pass the flag see no change.

Details
  • After M minutes everything still attached is released through the park path; a further grace period later it drains as a last resort. It exits 0 as soon as no session is held.
  • A second signal drains immediately; a third force-exits.
  • Help text warns that the supervisor's stop timeout must exceed M minutes plus the grace plus the shutdown budget, and the troubleshooting table gained a row for the new exit line.
  • New telemetry points self_hosted_defer_shutdown and self_hosted_defer_ceiling; poll-failure backoff now distinguishes timeout and transport errors from 5xx responses.
Usage
claude self-hosted-runner --defer-shutdown-max-min 30
Evidence

--defer-shutdown-max-min, --defer-shutdown-max-min <m>

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Read from
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's release notes agreeAdded claude self-hosted-runner --defer-shutdown-max-min <minutes>: on SIGTERM, keep serving attached sessions, park what is left after that…
The name it cites is new in this buildNew in this build: SELF_HOSTED_RUNNER_DEFER_SHUTDOWN_MAX_MS

See this entry in the whole of v2.1.238 →

Feedback