Ephemeral JIT runner hangs after "Acknowledging runner request" and never exits; job fails with "lost communication" (2.338.0, linux-x64)

Open
#4,855 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
42/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
csharp, github
Domain
ci-cd, devops

Research direction

Start with the runner listener logs and the request acknowledgement and credential token flow described in the report; compare the related issues #4309 and #2040 for clues. The report has no reproducer or named source files, so first trace where the listener waits after acknowledging a request and look for a way to reproduce the hang. Done means the runner starts the worker or exits cleanly when it cannot acquire the job.

Written by the indexing model from the issue text.

Description

Describe the bug

A runner registered with a JIT config (ephemeral, one job) accepts a job and then hangs. The listener's diag log ends at "Acknowledging runner request" and one token-request line. Nothing follows, and no Runner.Worker process is started. In the case we traced, GitHub failed the job about 10 minutes later with "The self-hosted runner lost communication with the server", and the registration was gone afterwards (GET /orgs/{org}/actions/runners/{id} returned 404).

The listener process never exits. It stays alive with 13 threads, its main thread in futex_wait and its TCP connections open, so the service manager never restarts it. Two runners on the same host hung this way about an hour apart. Each stayed hung for 6–7 hours, until we killed it.

To reproduce

We can't reproduce it on demand. Both cases had these conditions:

  • Runner 2.338.0, linux-x64, Ubuntu 24.04, kernel 6.8.
  • Registered via generate-jitconfig. .runner has "ephemeral": true and "disableUpdate": true. Started through runsvc.sh under systemd, one job per start.
  • The job request arrived within about a second of "Listening for Jobs".
  • The runner directory is read-only to the runner user, except _work and _diag. In normal operation this causes only the expected "Read-only file system: .credentials" error after a completed job. Hundreds of jobs a day complete normally on this host.
Expected behavior

The job runs. Or, if the listener cannot acquire it, the listener gives up and exits so the supervisor can restart it.

Runner version / OS

2.338.0, Ubuntu 24.04.4 LTS x86_64

Logs

The listener diag log, last lines. Both instances end the same way:

[17:35:23Z INFO BrokerMessageListener] Session created.
[17:35:23Z INFO Terminal] WRITE LINE: Current runner version: '2.338.0'
[17:35:23Z INFO Terminal] WRITE LINE: 2026-11-11 17:35:23Z: Listening for Jobs
[17:35:23Z INFO JobDispatcher] Set runner/worker IPC timeout to 30 seconds.
[17:35:23Z INFO BrokerMessageListener] Acknowledging runner request '<id>'.
[17:35:23Z INFO CredentialManager] Creating credential type: OAuth
[17:35:23Z INFO RSAFileKeyManager] Loading RSA key parameters from file <runner>/.credentials_rsaparams
[17:35:23Z INFO GitHubActionsService] AAD Correlation ID for this token request: Unknown

Nothing follows these lines, and there is no Worker log.

Job annotation: "The self-hosted runner lost communication with the server. Verify the machine is running and has a healthy network connection. ..."

Possibly related: #4309, #2040.

Dominant language
C#
Stars
6.4k
Forks
1.5k
Avg merge
1d 7h
Merged PRs (30d)
36

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from actions/runner

All issues in actions/runner

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.