Known Issues and Workarounds

This page lists known issues with running on certain platforms or hardware configurations.

Linux Wayland w/ Nvidia GPU

Crashes When Closing a Game Window

This is caused by a bug in Nvidia's Linux graphics drivers, specific to Wayland and Vulkan. It is possibly fixed on newer GPUs or newer driver versions.

If you encounter this, you can fix it by setting this environment variable to force the application to use XWayland instead of native Wayland:

SDL_VIDEODRIVER=x11

Note that any program that uses SDL3 or SDL2 will respect this environment variable, so you probably only want to set it when running the emulator.