[session 1] docs(browser): GPU must run out-of-process (SwiftShader int3 crash, #97) #53

2026-07-22T13:09:23-04:00

hiveiq commented

2026-07-22 13:09:23 -04:00

Documents the fix from hiveops-browser #97 / #98 in the Guide (technical.browser Gotchas).

Session: 1

Adds a gotcha covering: the SwiftShader compositor int3 crash, why --in-process-gpu made it fatal (~hourly app close, even idle), the out-of-process fix, the HIVEOPS_GPU=hardware override, diagnostics (journalctl + --type=gpu-process check), and the not-an-OOM distinction.

Docs-only, single content file.

Documents the fix from hiveops-browser #97 / #98 in the Guide (`technical.browser` Gotchas). Session: 1 Adds a gotcha covering: the SwiftShader compositor `int3` crash, why `--in-process-gpu` made it fatal (~hourly app close, even idle), the out-of-process fix, the `HIVEOPS_GPU=hardware` override, diagnostics (`journalctl` + `--type=gpu-process` check), and the not-an-OOM distinction. Docs-only, single content file.

hiveiq added 1 commit 2026-07-22 13:09:24 -04:00

docs(technical.browser): GPU must run out-of-process (SwiftShader int3 crash, #97 ) 668da77241

Document the ~hourly Linux crash: SwiftShader compositor int3 is fatal only under
--in-process-gpu. Add the load-bearing rule (never in-process-gpu), the HIVEOPS_GPU
override, diagnostics, and the not-an-OOM distinction.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

johannes approved these changes 2026-07-22 13:09:52 -04:00

hiveiq merged commit 8cce424b91 into develop

2026-07-22 13:11:16 -04:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: hiveiq-src/hiveops-guide#53