diegosouzapw/OmniRoute · error · HeadroomError

STOP_FAILED

STOP_FAILED

Error message

Failed to stop headroom proxy: ${msg}

What it means

Error "Failed to stop headroom proxy: ${msg}" thrown in diegosouzapw/OmniRoute.

Source

Thrown at src/lib/headroom/process.ts:175

  const pid = getManagedPid();
  if (!pid) return { stopped: false, reason: "not_running" };
  try {
    process.kill(pid, "SIGTERM");
    setTimeout(() => {
      if (isPidAlive(pid)) {
        try {
          process.kill(pid, "SIGKILL");
        } catch {
          // already gone
        }
      }
    }, STOP_GRACE_MS);
    clearPid();
    return { stopped: true, pid };
  } catch (e) {
    clearPid();
    const msg = e instanceof Error ? e.message : String(e);
    throw new HeadroomError(`Failed to stop headroom proxy: ${msg}`, "STOP_FAILED");
  }
}

View on GitHub (pinned to a179ffed5b)

When it happens

Trigger: Thrown at src/lib/headroom/process.ts:175 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of diegosouzapw/OmniRoute@a179ffed5b (2026-08-25). Data as JSON: /api/errors/efdb21ebe53b4b3f. Report an issue: GitHub.