docs(installer): print Linux AppImage fallback hint

[aqilaziz]

Summary

• add a Linux installer post-install hint for AppImage startup failures
• mention the Debian/Ubuntu .deb fallback for Interpreter not found and unshare uid_map errors
• ask reporters for distro, kernel, GPU driver, and exact AppImage asset name

Refs #2380
Refs #2368

Checks

• bash -n scripts/install.sh
• git diff --check

Summary by CodeRabbit

• Chores
  • Improved Linux installer post-install messaging to help when the AppImage fails to run (e.g., missing interpreter or unshare/uid_map errors). Guidance now suggests trying the .deb package and, if problems persist, filing an issue with distro and kernel info, GPU/driver details, a dmesg excerpt, and the detected installer asset name.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 39c0061f-09bb-43fa-8143-ef0064aed3db

📥 Commits

Reviewing files that changed from the base of the PR and between c1bf04f and f83ba18.

📒 Files selected for processing (1)

• scripts/install.sh

---

📝 Walkthrough

Walkthrough

The Linux installer appends user guidance to the post-install output advising a .deb fallback and listing diagnostic information (distro, kernel, GPU driver, dmesg excerpt, detected asset) to include when reporting AppImage execution failures.

Changes

Post-install guidance enhancement

Layer / File(s)	Summary
Post-install guidance messages for AppImage failures scripts/install.sh	Adds multiple echo lines after the "OpenHuman is ready" output to suggest trying the .deb package and to request distro (uname -a), GPU driver (lspci), dmesg excerpt, and detected asset name when AppImage fails due to missing interpreter or unshare/uid_map errors.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

• senamakel

Poem

🐰 A tiny script hops, leaves notes in the night,
"If AppImage trips, try .deb — set things right.
Gather uname, lspci, dmesg's small song,
Tell us the asset, and we'll fix what's wrong." 🎩✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly and accurately summarizes the main change: adding a fallback hint for Linux AppImage in the installer script.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ 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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

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 `@scripts/install.sh`:
- Around line 624-626: Update the troubleshooting echo messages that mention
".deb package" and "report your distro, kernel, GPU driver, and ${ASSET_NAME}"
so they include direct, actionable links: add the URL where the .deb package can
be downloaded and a URL to the project's issue tracker or support/bug template
for reporting diagnostics; ensure the message also points users to any
diagnostic command output to include (e.g., uname -a, lspci, dmesg) and
reference the same ${ASSET_NAME} symbol so the printed guidance is specific and
clickable.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ae909660-86d8-43ed-9677-499698edb72d

📥 Commits

Reviewing files that changed from the base of the PR and between 369a392 and c1bf04f.

📒 Files selected for processing (1)

• scripts/install.sh

[graycyrus]

Looks good, nice work!