# NousResearch/hermes-agent · Gateway restart port race and API server handoff

## Open now

- Nothing open on GitHub.

These items concern a race condition where the gateway restart process conflicts with its own port, leaving the API server unavailable or the gateway running indefinitely. The work involves retrying on EADDRINUSE and ensuring the replacement process waits for the API server port to be ready before starting.

## TL;DR

- 4 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 2 PR(s) closed without merging.
- A fix was merged to main in PR #115347. Verify it addresses your case.
- **Recommended:** read PR #115347 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-115347`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.50`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #91547: \`hermes gateway restart\` races its own port, then runs indefinitely with no API server

## Prior & competing PRs

- **#115347: gateway restart no longer loses the api_server port; a parked platform reports degraded (#91547, salvage #92060 #113455)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `contributors/emails/[redacted:email]`, `gateway/platforms/api_server.py`, `gateway/run_shutdown.py`, `gateway/run_startup.py`, `gateway/status.py`, `hermes_cli/gateway.py`, `hermes_cli/gateway_windows.py`, `hermes_cli/web_routers/status.py`, `tests/gateway/test_runner_startup_failures.py`, `tests/gateway/test_startup_failed_platform_reports_degraded.py`, `tests/gateway/test_status.py`, `tests/hermes_cli/test_gateway.py`, `tests/hermes_cli/test_gateway_service.py`
- **#92060: fix(gateway): wait for api_server port before a replacement starts**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#115347`
- **#96419: fix(api-server): retry EADDRINUSE briefly across gateway restart handoff**. closed without merge
  - maintainer direction: category `merged_via`; implication `superseded`; refs `#115347`, `#91547`

## Fix status

- Merged to main in PR #115347 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-09-18`.
- Subsystem: `gateway`