RapidRAW Logo RapidRAW
Verified in v1.6.7
Documentation Menu

Troubleshooting on Linux

Crash when opening a photo

  1. Make sure you have working Vulkan drivers (vulkaninfo --summary should list your GPU).
  2. Open Settings → Processing → Processing Backend.
  3. Choose Vulkan, click Save & Relaunch and try again.
  4. If that fails, choose OpenGL.

(DirectX 12 may appear in the list but does not work on Linux.)

If the GPU crashed during start-up, RapidRAW switches to OpenGL by itself on the next launch.

Window is blank, flickers or crashes (Wayland, NVIDIA)

RapidRAW applies a workaround for NVIDIA on Wayland automatically. If you still see a blank window, flickering or crashes in the interface:

  1. Turn on Settings → Processing → Linux Compatibility Mode and click Save & Relaunch. This turns off GPU compositing in the interface (the image itself is still rendered on the GPU).
  2. If you can't reach the settings, start RapidRAW once with the same fix by hand:
WEBKIT_DISABLE_DMABUF_RENDERER=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 RapidRAW

Logging into an X11 session instead of Wayland is another option. See #306.

AppImage doesn't start

  • Make it executable: chmod +x RapidRAW_*.AppImage.
  • Older distributions may need FUSE 2: sudo apt install libfuse2 (Ubuntu 22.04) or libfuse2t64 (Ubuntu 24.04).
  • On older systems, use the build for Ubuntu 22.04.
  • The Flatpak or .deb / .rpm packages avoid these issues and integrate better with your desktop.

Slow on a hybrid laptop

Start RapidRAW on the dedicated GPU:

DRI_PRIME=1 RapidRAW      # AMD / Intel
prime-run RapidRAW        # NVIDIA

AI features

On Linux, all AI features run on the CPU. A faster CPU makes AI masks and AI denoise faster; the editor itself always uses the GPU.

The log file

~/.local/share/io.github.CyberTimon.RapidRAW/logs/app.log

For the Flatpak: ~/.var/app/io.github.CyberTimon.RapidRAW/data/io.github.CyberTimon.RapidRAW/logs/app.log.

The log is cleared on every start. To watch it live, or to also capture messages that don't make it into the log:

tail -f ~/.local/share/io.github.CyberTimon.RapidRAW/logs/app.log
RapidRAW 2>&1 | tee ~/rapidraw-crash.log

See Filing a Bug Report.

See also