Linux diagnostics · Gaming
Linux Gaming Repair Center
Diagnose crashes, Proton failures, Vulkan issues and Linux gaming performance problems.
Local analysis. No uploads. Start with what failed, collect a small piece of evidence and test one reversible change. Logs stay in this page; reset or leaving it clears the tools.
01
Proton & Wine Doctor / Crash Investigator
A startup error, a frozen display and a system hard-lock need different evidence. Choose a symptom and answer the next question; the flow explains what each observation does and does not show.
Wine, Proton, DXVK and VKD3D-Proton: which layer is failing?
- Wine
- Implements Windows APIs. A prefix holds the application’s registry, files and configuration; changing or deleting it can remove settings and saves.
- Proton
- Steam’s game runtime combines Wine with graphics translation and integration patches. Experimental and community GE builds are different releases, not guaranteed fixes. Record the exact selected build before a controlled comparison.
- DXVK
- Translates supported Direct3D 8–11 paths to Vulkan. Device creation depends on the installed DXVK version, its required Vulkan features and the matching process architecture.
- VKD3D-Proton
- Translates Direct3D 12 to Vulkan. A working DXVK game does not establish the device features required by a different D3D12 game.
Launcher authentication, required runtime components and publisher-enabled anti-cheat support are separate startup constraints. Check the first failure and the game’s own support statements before treating a graphics warning as the cause.
Read the startup investigation guide · Investigate the D3D12 path
Choose an assistant above. You can go back or restart without changing anything on your system.
For a static starting point, open the guide for your failure: game startup, movement stalls / hard-locks, controller input.
02
Gaming Log Inspector
Inspect a Proton, Wine, DXVK, VKD3D-Proton or journal excerpt in this browser. Findings are clues, not a confirmed root cause. GPU, PCIe and storage evidence stay separate, including when they appear together.
Synthetic anonymized Cthulhu replay — storage evidence, no final GPU error
An anonymized acceptance case derived from Dennis’s documented Cthulhu investigation. The loaded excerpt is synthetic test data, not an original machine log.
- Documented workstation: Ryzen 7 5800X3D, Radeon RX 9060 XT 16 GiB / Navi 44, NixOS. These identifiers do not establish rendering success.
- Lightweight games remained stable; movement in S.T.A.L.K.E.R. 2 produced 1–2-second stalls or hard-locks. Some hard-locks left no useful final GPU message.
- Older Arch Linux testing separately reported the GPU disappearing from the PCIe bus. That earlier observation is not inserted into this no-final-error log.
- Moving the game from SATA to NVMe did not eliminate the problem. A 112 W GPU cap avoided some hard crashes but stalls persisted; neither observation proves a cause.
- The SATA interface/CRC errors and link resets are a distinct I/O hypothesis. GPU/PCIe, kernel/firmware and graphics-userspace hypotheses require their own evidence.
Illustrative replay only. Timestamps are synthetic; symptoms and historical versions are supplied observations. No causal ordering, failed GPU event, confirmed root cause or fix is invented. The underlying problem remains unresolved.
Paste a relevant excerpt. Do not include passwords or tokens. Matched evidence is redacted; summaries contain selected findings and metadata without raw lines. Review every summary before sharing it.
Limit: 1,048,576 characters · 12,000 lines · 8,192 characters per line. Files: up to 1 MiB.
Review the diagnostic summary
This preview omits raw log lines. Redaction cannot recognize every secret: check the text before copying or downloading. These buttons never post anything.
No final GPU message does not rule out a GPU failure. Storage resets establish storage trouble, not the cause of every freeze. Investigation guide.
03
Vulkan & Graphics Stack Inspector
Hardware identification, the bound kernel driver, Vulkan device enumeration and successful game rendering are four different observations. A 64-bit host Vulkan report also does not prove that a 32-bit game runtime can load its driver.
RADV and Intel ANV are Mesa Vulkan drivers; AMDVLK and NVIDIA use different driver paths. Check the selected ICD and runtime before forcing a driver. Wayland, X11 and Gamescope add presentation context, not an automatic explanation for a crash.
Paste evidence you already collected. This inspector reads text; it cannot access your GPU. Limit: 128 Ki characters. Nothing is executed or uploaded.
Start with a read-only graphics check
Read the PCI identity and “Kernel driver in use” separately. The “Kernel modules” field lists candidates. Then inspect Vulkan in the process architecture and container used by the game.
Read-only observation
lspci -nnkRequirements: Requires pciutils. PCI enumeration is read-only; optional detail may require additional permission.
Keep the GPU PCI ID and “Kernel driver in use” together. “Kernel modules” lists candidates and does not establish binding.
Vulkan loader and ICD guide · 32-bit runtime guide · Hardware Explorer
04
Steam Launch Options Builder
Build a temporary diagnostic launch string from reviewed options. Choose the application API and runtime first. An option is a controlled test with requirements and side effects; it is not a general performance recommendation.
A minimal Proton logging test
PROTON_LOG=1 %command%For a Steam game actually using Proton. It creates a diagnostic log and adds logging overhead; the exact destination depends on the runtime. Remove PROTON_LOG=1 after the test. The log may contain private paths and identifiers. The builder never changes Steam.
05
Performance & Frame-Time Troubleshooting
Average FPS hides brief stalls. Compare frame times during the same reproducible scene and use per-core CPU load, GPU use, VRAM and I/O as context. A single snapshot cannot establish a bottleneck or a hardware fault.
What a useful comparison records
Record the scene, resolution, render scale / FSR mode, FPS cap, VSync, Gamescope use, graphics API and Proton build. Keep those fixed while testing one setting. Lower render resolution can test GPU pressure; it cannot fix a kernel reset or prove the CPU is at fault.
Repeat first-pass stutter before clearing caches. For thermal or power suspicion, observe clocks and temperatures at the same timestamps; a low power reading during a stall may be its consequence. Movement-related stalls also require storage and memory evidence.
06
Gaming Knowledge Base
Focused guides with commands, interpretation, safe tests, rollback and primary references. A source review is not a reproduced compatibility result.
A Proton game fails to launch
Find the earliest blocking failure and separate the game, launcher, compatibility tool and host graphics stack.
Source review: 2026-10-10
Vulkan initialization fails
Separate PCI identity, kernel binding, loader discovery, usable Vulkan devices and actual game rendering.
Source review: 2026-10-10 · Hardware context
DXVK cannot find a usable Vulkan device
Check the DXVK build actually used by the game, its feature requirements and any device filters.
Source review: 2026-10-10 · Hardware context
Check missing 32-bit Vulkan support
A working 64-bit probe is insufficient for a process that needs a different loader and driver architecture.
Source review: 2026-10-10
The game selects the wrong GPU
Compare enumerated adapters with the renderer actually selected by the game before applying offload options.
Source review: 2026-10-10 · Hardware context
A game triggers an AMDGPU ring timeout
A missed GPU completion is a failure observation. Preserve its context before comparing workloads or software generations.
Source review: 2026-10-10 · Hardware context
NVIDIA kernel module and libraries disagree
Compare the loaded driver with installed components and distinguish a stale module from a module that never loaded.
Source review: 2026-10-10 · Hardware context
A Direct3D 12 game fails in VKD3D-Proton
Check the bundled translation layer and selected GPU features, then separate initialization from device loss under load.
Source review: 2026-10-10 · Hardware context
Distinguish shader compilation from other stutter
Compare repeatable frame-time spikes with compiler activity, CPU work, memory pressure and storage activity.
Source review: 2026-10-10 · Hardware context
A game freezes when moving through the world
Keep streaming stalls, GPU failures and total hard-locks separate, using the documented Cthulhu observations as an unresolved example.
Source review: 2026-10-10 · Hardware context
A USB controller is missing from Steam
Follow the controller from USB enumeration to kernel input, user-session access, Steam Input and game mapping.
Source review: 2026-10-10 · Hardware context
A game will not start on Steam Deck
Inspect the per-game compatibility tool, installed game variant, storage and supported SteamOS workflow.
Source review: 2026-10-10 · Hardware context
Audio is missing or crackles in Wine and Proton
Compare the host audio session with the game stream, routing, mute state and dropout evidence.
Source review: 2026-10-10 · Hardware context
Steam Linux Runtime or pressure-vessel fails
Investigate container startup separately from Proton and Vulkan errors.
Source review: 2026-10-10
Steam Flatpak cannot see the game library
Trace sandbox filesystem visibility without globally disabling isolation.
Source review: 2026-10-10
Steam library fails on noexec or permissions
Separate mount flags, ownership, download failure and executable launch errors.
Source review: 2026-10-10
Proton game on NTFS fails to create its prefix
Identify unsupported shared-library layouts and protect saves before migrating.
Source review: 2026-10-10
A Proton prefix stops working after an update
Protect local saves and distinguish prefix migration from renderer and launcher failures.
Source review: 2026-10-10
Lutris game refuses to launch through Wine
Distinguish Lutris frontend, runner, Wine prefix and Vulkan from one another.
Source review: 2026-10-10
Heroic cannot authenticate or launch an Epic/GOG game
Diagnose account, Legendary, store metadata and sandbox problems separately.
Source review: 2026-10-10
Multiplayer fails because anti-cheat is unsupported
Check title-specific developer support without recommending anti-cheat bypasses.
Source review: 2026-10-10
Gamescope shows a black window or wrong refresh rate
Inspect nested compositor setup separately from game Vulkan device failures.
Source review: 2026-10-10
Steam download, update or file verification loops
Separate download transport, disk writes, filesystem space and content validation.
Source review: 2026-10-10
No guide matches this search. Try a component or symptom name.