Skip to content

fix(appimage): stop bundling libwayland-client to prevent EGL crash on Linux - #58

Open
DanielJohn17 wants to merge 1 commit into
veloxbase:mainfrom
DanielJohn17:fix/appimage-unbundle-host-graphics-libs
Open

DanielJohn17 wants to merge 1 commit into
veloxbase:mainfrom
DanielJohn17:fix/appimage-unbundle-host-graphics-libs

Conversation

@DanielJohn17

Copy link
Copy Markdown

Fix AppImage webview crash: stop bundling libwayland-client.so.0

Closes #47. The AppImage bundled WebKit's libwayland-client.so.0 (shipped by tauri-bundler's linuxdeploy). It shadows the host library, so when glvnd loads the host Mesa stack, libEGL_mesa can't resolve the interface it needs and eglGetPlatformDisplay returns EGL_BAD_PARAMETER. WebKitWebProcess then aborts:

Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...

This broke the AppImage on Fedora/GNOME (from #47) and reproduced identically on Arch/Hyprland, both direct launch and via the org.freedesktop.FileManager1 D-Bus activation.

Fix: after tauri build, unpack the AppImage in CI, drop usr/lib/libwayland-client.so.0, and repack. Verified A/B locally: removing just that one library turns an instant abort into a working webview. The .deb is unaffected — it links host libraries.

Tauri tracks this upstream in tauri-apps/tauri#16062 (update linuxdeploy); this step can be dropped once that ships in tauri-bundler.

Verification performed on an affected machine (Arch + Hyprland, Intel Ivy Bridge):

  • Fixed build: app launches, WebKitWebProcess stays alive, no EGL error.
  • Original build, same direct launch: identical EGL_BAD_PARAMETER abort.

…n Linux

WebKitWebProcess aborts with "Could not create default EGL display:
EGL_BAD_PARAMETER. Aborting..." because linuxdeploy bundles
libwayland-client.so.0, which shadows the host library and breaks the
host Mesa/EGL stack glvnd loads. Strip it from the AppImage after
bundling on Linux CI builds. See veloxbase#47; tracked upstream at
tauri-apps/tauri#16062.
@DanielJohn17
DanielJohn17 force-pushed the fix/appimage-unbundle-host-graphics-libs branch from 8a11e65 to a5447bd Compare September 24, 2026 22:01
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.

AppImage bundles libwayland-client causing EGL failure on Fedora 44 Wayland

1 participant