Troubleshooting

Troubleshooting

No effect / DRM still fails

1. Confirm Proton is GE or CachyOS, not stock Valve.
2. Confirm LinUwUx is on the game command, not linuwux lutris (Common mistakes).
3. linuwux --version matches what you expect.
4. Host-side requirements are in place — UMIP disabled where needed, CPUID faulting or hypervisor set up on CPUs that need it (Prerequisites; full guide on cs.rin.ru).
5. The game dir (beside the Windows target exe) has a marker: reflex.dll, reflex64.dll, or DenuvOwO.ini. With LINUWUX_DEBUG=1 you should see Found … and Found game: … for the real game process — not only helper noise.
6. If the pack includes launcher.exe, launch the game binary instead (Common mistakes).

Host setup (UMIP / hypervisor)

If the library loads but DRM still fails, confirm host prerequisites — not only launch options. See Prerequisites. Do not expect liblinuwux.so to disable UMIP or install HV DKMS by itself.

Log spam / hundreds of “loaded” lines

You likely wrapped a launcher or entire process tree. Use per-game prefix/env only.

Overlay / MangoHud broken

You replaced LD_PRELOAD instead of appending, or used mangohud linuwux …. Use the wrapper and correct order (Common mistakes).

Gamescope + Lutris/Faugus

See Gamescope — unsupported smooth path for now.

Debug log for issues

Steam-style:

LINUWUX_DEBUG=1 linuwux %command%

Attach: linuwux --version, Proton build name, short description of game/DRM, and the log.