Hero Chrome crashes on WSL2 (SIGSEGV)

[m0n99]

Hey, I’m running Hero on WSL2 (Ubuntu 24.04) and the bundled Chrome crashes every time it tries to launch.

Here’s the full error from the console:

2025-11-09T16:52:38.109Z ERROR [hero-core/connections/ConnectionToHeroClient] ConnectionToClient.HandleRequestError { context: {}, sessionId: undefined, sessionName: undefined } BrowserLaunchError:
    at BrowserProcess.onChildProcessExit (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/agent/main/lib/BrowserProcess.ts:162:9)
    at Object.onceWrapper (node:events:623:26)
    at ChildProcess.emit (node:events:508:28)
    at ChildProcess._handle.onexit (node:internal/child_process:294:12)
------BROWSER_CREATION_Q--------------------------
    at Queue.run (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/node_modules/commons/lib/Queue.ts:63:19)
    at Pool.getBrowser (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/agent/main/lib/Pool.ts:144:44)
    at Agent.open (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/agent/main/lib/Agent.ts:126:34)
    at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
    at async Session.openBrowser (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/node_modules/core/lib/Session.ts:280:5)
    at async Session.create (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/node_modules/core/lib/Session.ts:961:7)
    at async ConnectionToHeroClient.createSession (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/node_modules/core/connections/ConnectionToHeroClient.ts:196:30)
    at async CommandRunner.runFn (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/node_modules/core/lib/CommandRunner.ts:36:14)
    at async ConnectionToHeroClient.executeCommand (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/node_modules/core/connections/ConnectionToHeroClient.ts:258:12)
    at async ConnectionToHeroClient.handleRequest (/home/mon/test-hero/node_modules/.pnpm/@[email protected]/node_modules/core/connections/ConnectionToHeroClient.ts:66:14) {
  message: 'Failed to launch Chrome! Browser exited prematurely (SIGSEGV)',

When I try to launch the Hero Chrome binary manually, it also crashes:

/home/mon/.cache/ulixee/chrome/139.0.7258.154/chrome https://ulixee.org --no-sandbox --disable-gpu
Segmentation fault

What I’ve tried: Installed all required system libs (libnss3, libasound2, libgtk-3-0, libx11-xcb1, etc.)

Installed chromium-browser via apt — that version works fine in WSL2. Only the bundled Chrome inside Hero crashes immediately.

[jensmogens]

You can try to enable debugging by setting the environment variable DEBUG to ulx* like so DEBUG=ulx*. Then it'll hopefully print out a more detailed error :)