Document Linux/Wayland AppImage launch-crash workaround in README#2465
Document Linux/Wayland AppImage launch-crash workaround in README#2465distorx wants to merge 1 commit into
Conversation
Add a note to the install section linking tinyhumansai#2463, which covers the CEF-prewarm X_ConfigureWindow crash on Wayland and the sharun "Interpreter not found!" loader failure on Arch-based distros, both with env-var workarounds. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
📝 WalkthroughWalkthroughThe README is updated with a Linux-specific troubleshooting note warning users that the AppImage can crash on launch under Wayland and certain Arch-based distributions. The note references GitHub issue ChangesLinux AppImage Compatibility Note
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~2 minutes Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@README.md`:
- Line 71: Update the README blockquote for consistency by capitalizing the
first word after the colon: change "Linux: the AppImage can crash on launch..."
to "Linux: The AppImage can crash on launch..."; locate the string in the README
line that begins "**Linux:** the AppImage..." and make the one-word
capitalization change to match the existing blockquote pattern (e.g., like
"**Early Beta**: Under active...").
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
| irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex | ||
| ``` | ||
|
|
||
| > **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds. |
There was a problem hiding this comment.
Capitalize "The" for consistency with the established blockquote pattern.
Line 57 capitalizes the first word after the colon (**Early Beta**: Under active...). For consistency, "the AppImage" should be "The AppImage".
📝 Proposed fix
-> **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [`#2463`](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.
+> **Linux:** The AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [`#2463`](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| > **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds. | |
| > **Linux:** The AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [`#2463`](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds. |
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@README.md` at line 71, Update the README blockquote for consistency by
capitalizing the first word after the colon: change "Linux: the AppImage can
crash on launch..." to "Linux: The AppImage can crash on launch..."; locate the
string in the README line that begins "**Linux:** the AppImage..." and make the
one-word capitalization change to match the existing blockquote pattern (e.g.,
like "**Early Beta**: Under active...").
1 participant
Summary
README.md.Problem
curl … install.sh | bashquick-start in the README carries no Linux caveats, yet two distinct bugs currently stop the packaged AppImage from launching with no pointer from the README:X_ConfigureWindowBadWindowX error — CEF prewarm webview triggers a fatal X_ConfigureWindow BadWindow crash on Wayland #2463.sharunloader aborts withInterpreter not found!— Interpreter not found! #2417 / Interpreter not found! #2380 / [Linux] AppImage fails on Ubuntu 26.04 with unshare and "Interpreter not found!" #2368.Solution
> **Early Beta**:style, pointing at CEF prewarm webview triggers a fatal X_ConfigureWindow BadWindow crash on Wayland #2463 — whose comment documents both workarounds (OPENHUMAN_CEF_PREWARM=0andSHARUN_LDNAME=/lib64/ld-linux-x86-64.so.2, persisted via--appimage-add-env).Submission Checklist
diff-coverdoes not score Markdown.## Related— N/A: no feature rows affected.Closes #NNN— N/A: this PR documents a workaround; it does not fix CEF prewarm webview triggers a fatal X_ConfigureWindow BadWindow crash on Wayland #2463, so no closing keyword is used.Impact
Related
AI Authored PR Metadata (required for Codex/Linear PRs)
Linear Issue
Commit & Branch
docs/readme-linux-launch-workaround54bda893aaa669720e32b736d4a7189cc91caafcValidation Run
pnpm --filter openhuman-app format:check— N/A: documentation-only Markdown change; no JS/TS touched.pnpm typecheck— N/A: no code changed.Validation Blocked
command:N/Aerror:N/Aimpact:N/ABehavior Changes
Parity Contract
Duplicate / Superseded PR Handling
Summary by CodeRabbit