admin/openhuman
1
0
Fork 0
mirror of https://github.com/tinyhumansai/openhuman.git synced 2026-07-27 21:08:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(linux): add AppImage failure notes (#2391)

Browse Source
This commit is contained in:
Aqil Aziz
2026-05-22 16:54:02 +05:30
committed by GitHub
parent e6f08c6319
commit ddbd0fcbe5
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
gitbooks/features/platform.md
+17
View File
@@ -19,6 +19,23 @@ OpenHuman is a native desktop application, not a browser extension, not an Elect
| **Windows** | x64, ARM64 | `.msi` installer |
| **Linux** | x64 | AppImage, `.deb` |
### Linux AppImage notes
The Linux AppImage is built for x64 desktops and is the default asset selected
by the curl installer. On newer distributions, especially builds that tighten
unprivileged user namespaces or AppArmor defaults, AppImage startup can fail
before OpenHuman reaches its own crash reporter. Known symptoms include:
- `unshare: write failed /proc/self/uid_map: Operation not permitted`
- `Interpreter not found!`
- `cannot execute binary file`
When that happens, prefer the `.deb` package on Debian/Ubuntu systems. For
Fedora, openSUSE, and other non-Debian distributions, include the distro
version, kernel version, GPU/driver stack, and the exact AppImage filename when
reporting the issue so maintainers can distinguish host restrictions from a
badly packaged AppImage runtime.
***
## Why native matters