Skip to content

desktop install: work without libfuse2 (0.2.2) - #3

Merged
ralyodio merged 1 commit into
mainfrom
fix/desktop-no-libfuse2
Oct 6, 2026
Merged

ralyodio merged 1 commit into
mainfrom
fix/desktop-no-libfuse2

Conversation

@ralyodio

@ralyodio ralyodio commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Found while installing v0.2.1 on dev2: the AppImage fails with dlopen(): error loading libfuse.so.2 even though fusermount exists. AppImages need libfuse2; current Ubuntu/Kubuntu ship only fuse3.

  • install.sh checks for libfuse.so.2; without it, unpacks the AppImage once into ~/.local/opt/hqterm-desktop/app/ and points the launcher entry there (no per-launch extraction into /tmp).
  • hqterm desktop prefers app/hqterm-desktop and checks libfuse2 (not fusermount) before falling back to --appimage-extract-and-run.
  • Launcher icon is chmod 644 regardless of umask.
  • Verified on dev2 with a scratch HOME: installs, unpacks (326 MB), .desktop Exec points at the unpacked binary, locator finds it.

🤖 Generated with Claude Code

…m desktop prefers it (0.2.2)

fusermount being present does not mean an AppImage can mount: the runtime
needs libfuse.so.2, which fuse3-only distros (current Ubuntu/Kubuntu) lack.
Found on dev2: "dlopen(): error loading libfuse.so.2". Also chmod 644 the
launcher icon regardless of umask.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ralyodio
ralyodio merged commit a2db351 into main Oct 6, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant