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·Jun 11, 2025 05:07:40 UTC·YK-525
ResolvedBug

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 (53)

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

Closing this one. The NVIDIA plus Wayland crash is handled automatically since 2026.6.0, and the remaining AppImage cases are covered in Blank screen or crash on Linux. If you see it again on a current version, let me know here.

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.

gregg-cbs

Ubuntu Solution to blank screen

I made a script for Ubuntu users that installs Yaak the right way. Might work for other distros.

Steps

  1. Download Yaak AppImage from here: https://yaak.app/download
  2. Open your terminal, cd into your downloads folder.
  3. Copy the script below, change the APP_NAME in the script to your yaak app image file name in your downloads folder
  4. Paste the whole script into your terminal and press enter
  5. Search yaak in your applications and open it

What the script does?

It creates an app shortcut with the appropriate ENV so the app runs on your machine. You can always change the env for one of the other ones if you are on Wayland.

Script

#!/bin/bash

# Change this if your image has a different name
APP_NAME="yaak_2026.2.4_amd64.AppImage"

# 1. Configuration
TARGET_DIR="$HOME/Applications"
ICON_DIR="$HOME/.local/share/icons"
SHORTCUT_PATH="$HOME/.local/share/applications/yaak.desktop"

# 2. Setup folders
mkdir -p "$TARGET_DIR" "$ICON_DIR"

# 3. Copy AppImage (so it stays in Downloads too)
if [ -f "$HOME/Downloads/$APP_NAME" ]; then
    cp "$HOME/Downloads/$APP_NAME" "$TARGET_DIR/yaak.AppImage"
    chmod +x "$TARGET_DIR/yaak.AppImage"
    echo "AppImage copied to $TARGET_DIR"
else
    echo "Error: $APP_NAME not found in Downloads."
    exit 1
fi

# 4. Extract and move your specific High-DPI icon
echo "Extracting High-DPI icon..."
cd "$TARGET_DIR"
# Extracting specifically from the path you found
./yaak.AppImage --appimage-extract "usr/share/icons/hicolor/256x256@2/apps/yaak-app.png" > /dev/null 2>&1

if [ -f "squashfs-root/usr/share/icons/hicolor/256x256@2/apps/yaak-app.png" ]; then
    cp "squashfs-root/usr/share/icons/hicolor/256x256@2/apps/yaak-app.png" "$ICON_DIR/yaak-app.png"
    echo "Icon successfully installed to $ICON_DIR"
fi

# Clean up extraction artifacts
rm -rf squashfs-root

# 5. Create the Shortcut with Absolute Paths
cat <<EOT > "$SHORTCUT_PATH"
[Desktop Entry]
Type=Application
Name=Yaak
Comment=Modern API Client
Exec=env WEBKIT_DISABLE_COMPOSITING_MODE=1 $TARGET_DIR/yaak.AppImage
Icon=$ICON_DIR/yaak-app.png
Terminal=false
Categories=Development;
EOT

# 6. Finalize
chmod +x "$SHORTCUT_PATH"
update-desktop-database ~/.local/share/applications/

echo "------------------------------------------------"
echo "Yaak is ready! Search for 'Yaak' in your menu."
gregg-cbs
João Pedro Frech

Guys, this is the top 1 problem that appears in this forum, users cannot use it on Linux, please fix it, Appimage is not viable anymore (most distros don’t ship fuse2 anymore, it’s deprecated), community is moving towards Flatpak.

Koen Hendriks

I’m having this issue as well. On Manjaro (6.6.128-1-MANJARO) using Hyprland + Wayland.

It crashes on Gdk-Message: 10:08:59.101: Error 71 (Protocol error) dispatching to Wayland display.

Full Log:

[2026-05-06][08:08:58][INFO][yaak_models] Initializing app database "/home/koen/.local/share/app.yaak.desktop/db.sqlite"
[2026-05-06][08:08:58][INFO][yaak_models::migrate] Running database migrations
[2026-05-06][08:08:58][INFO][yaak_models::migrate] No migrations to run out of 66
[2026-05-06][08:08:58][INFO][yaak_models] Initializing blobs database "/home/koen/.local/share/app.yaak.desktop/blobs.sqlite"
[2026-05-06][08:08:58][INFO][yaak_models::blob_manager] Running blob database migrations
[2026-05-06][08:08:58][INFO][yaak_models::blob_manager] No blob migrations to run
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Starting plugin server on 127.0.0.1:37267
[2026-05-06][08:08:58][INFO][yaak_plugins::nodejs] Starting plugin runtime node=/usr/lib/yaak/vendored/node/yaaknode main=/usr/lib/yaak/vendored/plugin-runtime/index.cjs
[2026-05-06][08:08:58][INFO][yaak_plugins::nodejs] Spawned plugin runtime
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Waiting for plugins to initialize
[2026-05-06][08:08:58][INFO][yaak_plugins::server_ws] New plugin runtime websocket connection: 127.0.0.1:42156
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Plugin runtime client connected!
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Loading bundled plugins from "/usr/lib/yaak/vendored/plugins"
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Initializing all plugins
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Loading bundled plugins from "/usr/lib/yaak/vendored/plugins"
[2026-05-06][08:08:58][INFO][yaak_plugins::nodejs] Plugin runtime connected to websocket
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-jwt
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/action-copy-grpcurl
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/importer-postman-environment
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/action-copy-curl
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-prompt
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-timestamp
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-bearer
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-oauth1
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-json
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/themes-yaak
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/filter-jsonpath
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-oauth2
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-request
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/filter-xpath
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/action-send-folder
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-hash
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/importer-insomnia
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-cookie
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/importer-openapi
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-regex
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-ntlm
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-response
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-ctx
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-fs
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-xml
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-apikey
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-random
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/importer-postman
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/importer-yaak
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-basic
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/importer-curl
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-uuid
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/auth-aws
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-encode
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Adding plugin by dir /usr/lib/yaak/vendored/plugins/template-function-1password
[2026-05-06][08:08:58][INFO][yaak_plugins::manager] Initialized 35 plugins in 184.825142ms:
  - /usr/lib/yaak/vendored/plugins/auth-jwt
  - /usr/lib/yaak/vendored/plugins/action-copy-grpcurl
  - /usr/lib/yaak/vendored/plugins/importer-postman-environment
  - /usr/lib/yaak/vendored/plugins/action-copy-curl
  - /usr/lib/yaak/vendored/plugins/template-function-prompt
  - /usr/lib/yaak/vendored/plugins/template-function-timestamp
  - /usr/lib/yaak/vendored/plugins/auth-bearer
  - /usr/lib/yaak/vendored/plugins/auth-oauth1
  - /usr/lib/yaak/vendored/plugins/template-function-json
  - /usr/lib/yaak/vendored/plugins/themes-yaak
  - /usr/lib/yaak/vendored/plugins/filter-jsonpath
  - /usr/lib/yaak/vendored/plugins/auth-oauth2
  - /usr/lib/yaak/vendored/plugins/template-function-request
  - /usr/lib/yaak/vendored/plugins/filter-xpath
  - /usr/lib/yaak/vendored/plugins/action-send-folder
  - /usr/lib/yaak/vendored/plugins/template-function-hash
  - /usr/lib/yaak/vendored/plugins/importer-insomnia
  - /usr/lib/yaak/vendored/plugins/template-function-cookie
  - /usr/lib/yaak/vendored/plugins/importer-openapi
  - /usr/lib/yaak/vendored/plugins/template-function-regex
  - /usr/lib/yaak/vendored/plugins/auth-ntlm
  - /usr/lib/yaak/vendored/plugins/template-function-response
  - /usr/lib/yaak/vendored/plugins/template-function-ctx
  - /usr/lib/yaak/vendored/plugins/template-function-fs
  - /usr/lib/yaak/vendored/plugins/template-function-xml
  - /usr/lib/yaak/vendored/plugins/auth-apikey
  - /usr/lib/yaak/vendored/plugins/template-function-random
  - /usr/lib/yaak/vendored/plugins/importer-postman
  - /usr/lib/yaak/vendored/plugins/importer-yaak
  - /usr/lib/yaak/vendored/plugins/auth-basic
  - /usr/lib/yaak/vendored/plugins/importer-curl
  - /usr/lib/yaak/vendored/plugins/template-function-uuid
  - /usr/lib/yaak/vendored/plugins/auth-aws
  - /usr/lib/yaak/vendored/plugins/template-function-encode
  - /usr/lib/yaak/vendored/plugins/template-function-1password
[2026-05-06][08:08:58][INFO][tauri_app_lib::window] Create new window label=main_0
Gdk-Message: 10:08:59.101: Error 71 (Protocol error) dispatching to Wayland display.
Paulo Cezar Cury Seara

I had problem with blank screens in appimage before Yaak with other Tauri software in Arch with Hyprland, and now I’m having the same problem, but don’t have this problem with the AUR package. Probably something related to fuse2? Maybe flatpak is a better option?

Gregory SchierFeatured

Documented the known fixes here: Blank screen or crash on Linux

Alex Bradaric

I’ve had Yaak trigger a crash notification after I intentionally closed it. It seems related to NVIDIA/WebKit, but unlike most reports here, the app opens and works - the crash happens on exit.

I’m using:

  • Arch Linux / Omarchy with Hyprland on Wayland
  • Yaak 2026.7.1-1, installed through pacman, not AppImage
  • WebKitGTK 2.52.6-1
  • NVIDIA driver 610.57.04, RTX 3090

I checked the system logs with an assistant. There are three recorded crashes, on September 30, October 6, and October 12. All three are Yaak’s WebKitWebProcess, crashing with SIGSEGV in the SkiaGPUWorker thread inside libnvidia-eglcore.so.610.57.04.

For the latest one, Yaak logged application-exit cleanup at 12:52:16 CEST, and the renderer crashed a second later. The main thread was already in exit() and NVIDIA EGL cleanup. Part of the crashing thread’s stack is:

#0 libnvidia-eglcore.so.610.57.04 + 0x80a6c4
#1 libwebkit2gtk-4.1.so.0 + 0x4fc370a
#2 libwebkit2gtk-4.1.so.0 + 0x4fc37de
...
#8 libwebkit2gtk-4.1.so.0 + 0x452a91a
#9 __call_tls_dtors (libc.so.6)

I tried twice more afterward: once opening Yaak, running a request, interacting with the title bar, and closing it; then once just opening and closing it. Neither produced another core dump, so it seems intermittent.

I saw the comment saying the NVIDIA/Wayland crash is handled since 2026.6.0. I’m on a later version, but I don’t know if this is the same problem or a separate shutdown issue. I haven’t tried the latest release or the environment-variable workarounds yet.

Is this worth tracking here, or should I make a separate report? I can provide more redacted logs if needed.

Yaak Bot

This is a different crash from the one this post covered. That one happened at startup. Yours is WebKit’s renderer process segfaulting in the NVIDIA EGL driver during shutdown, after Yaak has already exited. Since the crash is inside WebKitGTK and the driver, Yaak’s code has little control over it, and updating to 2026.9.0 won’t change it. The most likely fix is launching with WEBKIT_DISABLE_DMABUF_RENDERER=1, which takes WebKit off the GPU path that’s crashing. Please open a separate post after a week or so, saying whether the crash notifications stopped.

Type to search feedback...