Skip to content

Linux AppImage (v0.2.6) aborts with "EGL_BAD_PARAMETER" / renders black or blank white window on newer Mesa hosts (bundled libwayland/libxkbcommon/libxcb conflict) #378

Description

@ket000

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:

  1. Running the AppImage as-is aborts immediately with:

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

  2. 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

  1. Download netscli-gui-linux-x86_64.AppImage from the v0.2.6 release.
  2. 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.
  3. 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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions