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·9 months 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 (44)

Sign in to leave a comment.

Yaak does not work on Pop!_OS 22.04 LTSwas merged
Crash on startup with AppImage on Arch Linuxwas merged
Yaak shows Gray screen after opening (AppImage)was merged
Blank screen on Fedora Linuxwas merged
Stefan Seemayer

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

SoftExpert
Stefan Seemayer

SoftExpert thanks, the deb based package is working great!

Gregory 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

NicTanghe

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

Gregory 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

Gregory Schier

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

Hao Xiang

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

Hao Xiang

but the appimage I build by myself works…

PandaDEV

I have the same issue on Arch with hyprland.

Joe Doe

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

Gregory Schier

Is this using the RPM package to install?

Azzam S.A

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.

Azzam S.A
Azzam S.A

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

Kent Jones

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.

ChiefCode

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

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

ChiefCode
App is not opening, blank GUI (v2025.5.6, Fedora 42 AppImage)
Abhay salvi
Yaak shows Gray screen after opening (AppImage)
sdwood
Yaak does not work on Pop!_OS 22.04 LTS
Stefan Seemayer
Crash on startup with AppImage on Arch Linux
Rubin Simons
Error 71 (Protocol error) dispatching to Wayland display
NicTanghe
appimage doesn`t run on arch
ismaail

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

sidesteps

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?

Dany Maillard

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

Stephen Eisenhauer

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