Method startServer

src/node/services/serverService.ts:348–463

* Start the HTTP/WS API server. * * @throws Error if a server is already running (check lockfile first)

(options: StartServerOptions)

   * @throws Error if a server is already running (check lockfile first)
   */
  async startServer(options: StartServerOptions): Promise<ServerInfo> {
    if (this.server) {
      throw new Error("Server already running in this process");
    }

    // Create lockfile instance for checking - don't store yet
    const lockfile = new ServerLockfile(options.muxHome);

    // Check for existing server (another process)
    const existing = await lockfile.read();
    if (existing) {
      throw new Error(
        `Another mux server is already running at ${existing.baseUrl} (PID: ${existing.pid})`
      );
    }

    const bindHost =
      typeof options.host === "string" && options.host.trim() ? options.host.trim() : "127.0.0.1";

    this.apiAuthToken = options.authToken;

    // Resolve the static assets directory (dist/) that contains index.html.
    // Non-bundled (Electron): __dirname is dist/node/services/, so ../.. reaches dist/.
    // Bundled (Docker):       __dirname is dist/runtime/, so .. reaches dist/.
    const staticDirCandidates = [path.join(__dirname, "../.."), path.join(__dirname, "..")];

    let staticDir: string | undefined;
    if (options.serveStatic) {
      for (const candidate of staticDirCandidates) {
        try {
          await fs.access(path.join(candidate, "index.html"));
          staticDir = candidate;
          break;
        } catch {
          // Try the next candidate.
        }
      }

      if (!staticDir) {
        log.warn(
          `API server static UI requested, but index.html is missing near ${__dirname}. Disabling.`
        );
      }
    }
    const serveStatic = options.serveStatic === true && staticDir !== undefined;

    // Non-CLI starts (desktop/browser mode) do not parse CLI flags, so allow an
    // explicit env override for TLS-terminating proxies that rewrite forwarded proto.
    const allowHttpOrigin = options.allowHttpOrigin ?? resolveAllowHttpOriginEnvFlag();

    const serverOptions: OrpcServerOptions = {
      host: bindHost,
      port: options.port ?? 0,
      context: options.context,
      authToken: options.authToken,
      router: options.router,
      desktopBridgeServer: options.context.desktopBridgeServer,
      serveStatic,