EADDRINUSE

EADDRINUSE

Error message

[API Bridge] Port ${apiPort} is already in use. API bridge disabled. (dashboard: ${dashboardPort})

What it means

Error "[API Bridge] Port ${apiPort} is already in use. API bridge disabled. (dashboard: ${dashboardPort})" thrown in diegosouzapw/OmniRoute.

Source

Thrown at src/lib/apiBridgeServer.ts:221

    if (!isOpenAiCompatiblePath(pathname)) {
      writeUpgradeProxyError(
        socket,
        404,
        JSON.stringify({
          error: "not_found",
          message: "API port only serves OpenAI-compatible routes.",
        })
      );
      return;
    }

    proxyUpgrade(req, socket, head, dashboardPort);
  });

  server.on("error", (error: NodeJS.ErrnoException) => {
    if (error?.code === "EADDRINUSE") {
      console.warn(
        `[API Bridge] Port ${apiPort} is already in use. API bridge disabled. (dashboard: ${dashboardPort})`
      );
      return;
    }
    console.warn("[API Bridge] Failed to start:", error?.message || error);
  });

  server.listen(apiPort, host, () => {
    globalThis.__omnirouteApiBridgeStarted = true;
    console.log(`[API Bridge] Listening on ${host}:${apiPort} -> dashboard:${dashboardPort}`);
  });
}

View on GitHub (pinned to a179ffed5b)

When it happens

Trigger: Thrown at src/lib/apiBridgeServer.ts:221 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/1b879a460e84d297. Report an issue: GitHub.