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·10 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 (47)

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.

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.

Type to search feedback...