Yaak Logo
Yaak
Feedback/Fix blank screen / Crash on Linux due to Wayland, NVIDIA, etc

Fix blank screen / Crash on Linux due to Wayland, NVIDIA, etc

Kendrick Ha·a year ago
TroubleshootingBug

Possible error messages:

  • Error 71 (Protocol error) dispatching to Wayland display

  • Cannot create EGL context: invalid display

If Yaak crashes or shows a blank screen on Linux, try setting one of the following environment variables:

  • WEBKIT_DISABLE_COMPOSITING_MODE=1 forces accelerated compositing off in WebKitGTK.

  • WEBKIT_DISABLE_DMABUF_RENDERER=1 disables the newer DMA-BUF renderer, which is the default in recent WebKitGTK and is generally the right path—except it’s been flaky with NVIDIA proprietary drivers(white/blank screens, flicker).

  • __NV_DISABLE_EXPLICIT_SYNC=1 makes the driver / EGL-Wayland layer turn off or ignore the explicit sync path and fall back to older (less strict) synchronization paths

Linux

Comments (32)

Sign in to leave a comment.

Greg Schier

I was able to extract the AppImage and replace libraries in ./usr/lib/ with versions from my system /usr/lib to get it working.

Greg Schier
Greg Schier

SoftExpert thanks, the deb based package is working great!

Greg Schier

Tauri has a few bugs regarding Linux AppImage support at the moment. This one could be related to this? https://github.com/tauri-apps/tauri/issues/9304

Greg Schier

( please note that i cant tesst the git version or the bin versions or whatever becouse web2kitgtk whatever version 4.2 doesnt want to download either becouse of issues with keys or becouse its not available on the mainrepo.

Greg Schier

This is likely the issue you’re facing. There’s a workaround near the bottom

https://github.com/yaakapp/app/issues/80#issuecomment-2345260666

Greg Schier

There are also a couple AUR packages for Yaak, which work https://aur.archlinux.org/packages/yaak

Greg Schier

version 2024.12.0 appimage not work in manjaro

❯ ./yaak_2024.12.0_amd64.AppImage
Gtk-Message: 19:51:29.049: Failed to load module "xapp-gtk3-module"
Gtk-Message: 19:51:29.050: Failed to load module "xapp-gtk3-module"
[2024-11-18][11:51:29][INFO][yaak_models::plugin] Creating database file at "/home/hxzhao/.local/share/app.yaak.desktop/db.sqlite"
[2024-11-18][11:51:29][INFO][yaak_models::plugin] Connecting to database at sqlite:///home/hxzhao/.local/share/app.yaak.desktop/db.sqlite?mode=rwc
[2024-11-18][11:51:29][INFO][yaak_models::plugin] Running database migrations from: /tmp/.mount_yaak_2wDAUiz/usr/lib/yaak/migrations
[2024-11-18][11:51:29][INFO][yaak_models::plugin] Database migrations complete
[2024-11-18][11:51:29][INFO][yaak_plugin_runtime::manager] Starting plugin server
[2024-11-18][11:51:29][INFO][yaak_plugin_runtime::manager] Starting gRPC plugin server on [::1]:42493
[2024-11-18][11:51:29][INFO][yaak_plugin_runtime::nodejs] Starting plugin runtime main=/tmp/.mount_yaak_2wDAUiz/usr/lib/yaak/vendored/plugin-runtime/index.cjs
[2024-11-18][11:51:29][INFO][yaak_plugin_runtime::nodejs] Spawned plugin runtime
[2024-11-18][11:51:29][INFO][tauri_app_lib] Create new window label=main_0
[2024-11-18][11:51:29][INFO][tauri_app_lib::updates] Checking for updates mode=stable
Gtk-Message: 19:51:29.628: Failed to load module "xapp-gtk3-module"
Gtk-Message: 19:51:29.630: Failed to load module "xapp-gtk3-module"
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...
Stream was cancelled by server

Greg Schier

but the appimage I build by myself works…

Greg Schier

I have the same issue on Arch with hyprland.

Greg Schier

Same issue here, using both the stable & beta versions of the app using Fedora 42.

Greg Schier

Is this using the RPM package to install?

Greg Schier

I tried the RPM package. It has the same issue when launched from the app menu, but it works fine when run from the terminal.

I suspect it’s failing to read some environment variables.

Greg Schier
Greg Schier

This issue was solved in the recent release (2025.5.0).
Thanks for Yaak. 🧁

Greg Schier

Sounds like your missing some video drivers. EGL is “OpenGL ES / Vulkan”. I’d start by installing the mesa drivers. It could also be an issue between X11 and Wayland.

Greg Schier

Related. 2025-08-19, Fedora 42, Yaak 2025.5.6 (AppImage).

Greg Schier

I’m marking this as “Won’t Fix” because there isn’t really anything I can do in the app. I’ve update the main description with a workaround.

Greg Schier
Blank screen on Fedora Linux
Greg Schier
App is not opening, blank GUI (v2025.5.6, Fedora 42 AppImage)
Greg Schier
Yaak shows Gray screen after opening (AppImage)
Greg Schier
Yaak does not work on Pop!_OS 22.04 LTS
Greg Schier
Crash on startup with AppImage on Arch Linux
Greg Schier
Error 71 (Protocol error) dispatching to Wayland display
Greg Schier
appimage doesn`t run on arch
Greg Schier
Error EGL display
Greg Schier

Running Arch Linux. The only way I got Yaak to run properly on Gnome 49 (Wayland) is by installing yaak-bin from AUR.

Greg Schier

Same on Arch with X11. Launching it as:

WEBKIT_DISABLE_DMABUF_RENDERER=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 ./Desktop/yaak.AppImage

Getting blank gray screen. Is this the better than postman experience?

Greg Schier

On Arch (Intel hardware), I got this error:

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

I could fix it by running:

LD_PRELOAD=/usr/lib/libwayland-client.so yaak

Greg Schier

Not sure if the underlying problem is the same, but my experience (on Ubuntu 25.10 + NVidia + AppImage + Wayland) is that the UI launches fine but eventually stops updating/re-rendering (usually after focusing another application and then returning).

In this state the app is effectively frozen, though the mouse cursor still changes as I hover over places where text inputs and resize handles should be (and I can still exit using Alt+F4 without losing my changes).

João Pedro Frech

Same problem here, AppImage doesn’t work. Best solution is Flatpak, please add support.

Balázs Vágvölgyi

Setting WEBKIT_DISABLE_COMPOSITING_MODE=1 at the Exec= line in Yaak’s desktop entry file fixed this issue for me on Wayland:

vb2007@vbDesktop: ~/.local/share/applications $
cat yaak.desktop
[Desktop Entry]
Categories=Development;
Comment=Play with APIs, intuitively
Exec=sh -c 'WEBKIT_DISABLE_COMPOSITING_MODE=1 yaak-app %U'
...

Of course you’ll need to complete some base steps like you would with any other Electron / Tauri app Wayland fixes, like copying the desktop entry first from /usr/share/applications/ and reloading the desktop entries.

Type to search feedback...