Skip to content

Use uruntime for the AppImage so it runs without libfuse2 - #137

Open
sigmaSd wants to merge 1 commit into
masterfrom
uruntime-appimage
Open

sigmaSd wants to merge 1 commit into
masterfrom
uruntime-appimage

Conversation

@sigmaSd

@sigmaSd sigmaSd commented Sep 23, 2026

Copy link
Copy Markdown
Owner

Addresses the FUSE part of #136.

The AppImage is built with AppImageKit's continuous runtime, which requires libfuse2. Ubuntu 22.04+ and Fedora don't install it by default, so the nightly AppImage fails at startup with:

dlopen(): error loading libfuse.so.2
AppImages require FUSE to run.

This swaps the --runtime-file passed to appimagetool for uruntime's uruntime-appimage-squashfs-${arch} (the runtime Anylinux AppImages use). It uses FUSE when it can, otherwise falls back to mount namespaces or extract-and-run. It's a drop-in: same appimagetool invocation, same squashfs AppDir, both x86_64 and aarch64 assets exist. It's also pinned to a tag (v0.7.1) instead of the moving continuous release.

Tested

Built stimulator-x86_64.AppImage with the script on Ubuntu 24.04 with no libfuse2 installed:

  • Before (current script): fails immediately with error loading libfuse.so.2.
  • After: --appimage-version reports v0.7.1, the runtime starts the bundled deno and the app runs until it looks up libadwaita-1.so.0, which the test container doesn't have (GTK4/libadwaita are expected from the host, as before).
  • deno fmt --check / deno lint pass. aarch64 was not built locally, but the uruntime-appimage-squashfs-aarch64 asset exists at the pinned tag.

Not in scope

This does not make the AppImage run on Alpine/musl. The runtime itself is static musl, but the bundled deno is glibc and GTK4/libadwaita still come from the host. Full Anylinux support would mean bundling glibc + the GTK4 stack with sharun. Since @sigmasd/gtk loads GTK via FFI dlopen, those libs would have to be listed by hand, so that's a separate, larger change.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WrqyVv7K7HAEYqiG5pyauK


Generated by Claude Code

AppImageKit's runtime dlopens libfuse.so.2, which Ubuntu 22.04+ and
Fedora no longer install by default, so the nightly AppImage failed to
start there. uruntime uses FUSE when available and otherwise falls back
to mount namespaces or extract-and-run. Pinned to v0.7.1.

Refs #136

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WrqyVv7K7HAEYqiG5pyauK
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.

2 participants