Field Guide

GitHub self-hosted runners go offline after host patching or agent updates.

Use this to restore runner registration, service startup behavior, and outbound connectivity requirements.

What this issue pattern usually means.

This issue usually indicates drift in runner service health and control-plane connectivity. The objective is to separate symptom visibility from true root cause so containment and correction happen in the right order.

Confirm dependency and control-path assumptions first.

  • Confirm current scope in Self-hosted CI/CD runners and identify exactly which workloads or users are failing.
  • Validate recent changes affecting runner service health and control-plane connectivity, including policy updates, patching, certificates, or routing.
  • Compare healthy and failing paths to identify the first point where behavior diverges.
  • Check logs and telemetry for correlated warnings during the same failure window.
  • Capture evidence before rollback so permanent remediation can be implemented later.

Recover service quickly without creating hidden debt.

  • Reproduce with a scoped test while collecting timestamped evidence.
  • Restore minimal known-good path for critical traffic first.
  • Validate service behavior from multiple clients or nodes after correction.
  • Apply durable fix for runner service health and control-plane connectivity and remove temporary exceptions.
  • Document break condition, detection signal, and prevention controls for recurrence.