Describe the bug
netscli-gui-linux-x86_64.AppImage (v0.2.6) fails to start correctly on a
host with a newer Mesa than the AppImage was built against. Depending on the
GPU/compositor, this shows up as one of two related failures:
-
Running the AppImage as-is aborts immediately with:
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...
-
After removing the conflicting bundled libraries (see below), the app
window opens but renders as a solid black or blank white window with no
UI content — the WebKitGTK compositor fails to paint anything.
Root cause
The AppImage (built via linuxdeploy + the gtk plugin) bundles its own copies
of the display stack under usr/lib:
libwayland-client.so.0 libwayland-cursor.so.0
libwayland-egl.so.1 libwayland-server.so.0
libxkbcommon.so.0
libxcb-render.so.0 libxcb-shm.so.0
libXau.so.6 libXdmcp.so.6
AppRun.wrapped sets LD_LIBRARY_PATH so these bundled (older) libraries are
loaded ahead of the host's. On a host with a newer Mesa (e.g. CachyOS rolling,
Mesa 26.2.2), eglGetDisplay/eglGetPlatformDisplay fails against the stale
bundled libwayland-client, producing the EGL_BAD_PARAMETER abort.
This matches a known linuxdeploy/Tauri bundler issue:
tauri-apps/tauri#15976
and a duplicate: tauri-apps/tauri#15665
Separately, even after fixing the EGL abort, WebKitGTK's hardware compositing
path can fail silently and produce a black or blank white window (no error on
stderr) — seen on a VMware VM using the vmwgfx driver where 3D acceleration
is only partially/software-supported.
Steps to reproduce
- Download
netscli-gui-linux-x86_64.AppImage from the v0.2.6 release.
chmod +x and run it on a distro with a newer Mesa (e.g. CachyOS,
Fedora 44+, Arch) — observe the EGL_BAD_PARAMETER abort with no window.
- Apply the library-removal workaround below — the window now opens but is
solid black or blank white with no rendered content.
Workaround (confirmed working)
./netscli-gui-linux-x86_64.AppImage --appimage-extract
rm squashfs-root/usr/lib/{libwayland-client.so.0,libwayland-cursor.so.0,libwayland-egl.so.1,libwayland-server.so.0,libxkbcommon.so.0,libxcb-render.so.0,libxcb-shm.so.0,libXau.so.6,libXdmcp.so.6}
WEBKIT_DISABLE_COMPOSITING_MODE=1 ./squashfs-root/AppRun
Describe the bug
netscli-gui-linux-x86_64.AppImage(v0.2.6) fails to start correctly on ahost with a newer Mesa than the AppImage was built against. Depending on the
GPU/compositor, this shows up as one of two related failures:
Running the AppImage as-is aborts immediately with:
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...
After removing the conflicting bundled libraries (see below), the app
window opens but renders as a solid black or blank white window with no
UI content — the WebKitGTK compositor fails to paint anything.
Root cause
The AppImage (built via linuxdeploy + the gtk plugin) bundles its own copies
of the display stack under
usr/lib:AppRun.wrappedsetsLD_LIBRARY_PATHso these bundled (older) libraries areloaded ahead of the host's. On a host with a newer Mesa (e.g. CachyOS rolling,
Mesa 26.2.2),
eglGetDisplay/eglGetPlatformDisplayfails against the stalebundled
libwayland-client, producing the EGL_BAD_PARAMETER abort.This matches a known linuxdeploy/Tauri bundler issue:
tauri-apps/tauri#15976
and a duplicate: tauri-apps/tauri#15665
Separately, even after fixing the EGL abort, WebKitGTK's hardware compositing
path can fail silently and produce a black or blank white window (no error on
stderr) — seen on a VMware VM using the
vmwgfxdriver where 3D accelerationis only partially/software-supported.
Steps to reproduce
netscli-gui-linux-x86_64.AppImagefrom the v0.2.6 release.chmod +xand run it on a distro with a newer Mesa (e.g. CachyOS,Fedora 44+, Arch) — observe the EGL_BAD_PARAMETER abort with no window.
solid black or blank white with no rendered content.
Workaround (confirmed working)
./netscli-gui-linux-x86_64.AppImage --appimage-extract rm squashfs-root/usr/lib/{libwayland-client.so.0,libwayland-cursor.so.0,libwayland-egl.so.1,libwayland-server.so.0,libxkbcommon.so.0,libxcb-render.so.0,libxcb-shm.so.0,libXau.so.6,libXdmcp.so.6} WEBKIT_DISABLE_COMPOSITING_MODE=1 ./squashfs-root/AppRun