Skip to content

Troubleshooting

Aleksander edited this page Mar 2, 2025 · 6 revisions

Check logs

Wlx-S will often show troubleshooting tips in the logs, so it's good to always check them first.

By default, Wlx-S logs into /tmp/wlx.log.

Another way is to run Wlx in the terminal with --replace. This will stop the Wlx process started by SteamVR/WiVRn and start a new one that can be monitored in the terminal.

Troubleshooting segmentation faults (SIGSEGV)

Run Wlx-S in rust-gdb (or even regular gdb) to get more info about the segfault.

Attach this with the other logs that you have.

rust-gdb -ex run target/debug/wlx-overlay-s

WayVR Server not working on Hybrid Graphics (NVIDIA)

Try starting wlx-overlay-s with these environment variables, to force-use NVIDIA GPU:

EGL_PLATFORM=wayland __EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/10_nvidia.json __NV_PRIME_RENDER_OFFLOAD=1

This could also help with people having difficulties launching the WayVR Dashboard itself.