Proton is Valve's compatibility layer: it combines Wine with DXVK and VKD3D, which translate Direct3D calls into Vulkan. Most Windows games work without any input from you. The rest usually need one launch option, or a look at a log file.
Enable Proton for everything
- Open Steam and sign in.
- Go to Steam → Settings → Compatibility.
- Tick Enable Steam Play for supported titles (usually already on).
- Tick Enable Steam Play for all other titles and pick Proton Experimental in the dropdown.
- Restart Steam when it asks.
Games that previously showed “not available on your platform” now have an Install button.
Where launch options live
Right-click the game in your library → Properties → General → Launch Options. The box takes a single line of shell-style text.
ENV_VAR=value OTHER_VAR=value %command% --game-argument
Everything before %command% sets an environment variable. %command%
is a placeholder for the real launch command — never remove it. Anything after it is passed to
the game itself.
Change one variable at a time. Clear the box between tests, otherwise you will not know which one fixed the problem — or caused the new one. Launch options apply per game, so nothing here affects the rest of the library.
Proton troubleshooting variables
Log what Proton is doing
PROTON_LOG=1 %command%
Writes a log file to your home directory named steam-<APPID>.log. The app ID
is the number in the game's store URL (store.steampowered.com/app/620
for Portal 2, so steam-620.log). This is the first thing to set when a game crashes
or refuses to start, because it turns “it does not work” into a specific error.
Fall back from Vulkan to OpenGL
PROTON_USE_WINED3D=1 %command%
Switches rendering from DXVK (Vulkan) to WineD3D (OpenGL). Use it when Vulkan is the problem: the game starts and immediately dies, the screen stays black with sound playing, or the driver is older than the game expects. Expect lower frame rates — this is a diagnostic and a workaround, not an upgrade.
Turn off ESYNC
PROTON_NO_ESYNC=1 %command%
ESYNC is an eventfd-based synchronisation layer that reduces CPU overhead. It is stable on current kernels, but on some systems it causes a crash at launch or a hang on the loading screen. Disabling it costs a little performance and often buys a working game.
Turn off FSYNC
PROTON_NO_FSYNC=1 %command%
FSYNC uses futexes and is the newer of the two. If a game behaves strangely — audio stuttering, physics running at the wrong speed, freezes when a level loads — try this one. Both can be combined while you are narrowing things down:
PROTON_NO_ESYNC=1 PROTON_NO_FSYNC=1 %command%
NVIDIA users
__GL_SHADER_DISK_CACHE=1 %command%
Enables NVIDIA's on-disk shader cache. Compiled shaders are reused between runs, which removes
most of the stutter during the first minutes of a game and after every driver update. The cache
lives under ~/.nv/GLCache; deleting that directory is safe and only costs you one
recompile.
__GL_THREADED_OPTIMIZATIONS=1 %command%
Lets the NVIDIA driver move OpenGL work onto extra threads. It helps some older OpenGL titles and, in a minority of games, makes things worse — so test it rather than leaving it on for everything. It has no effect on Vulkan titles, which is most of what Proton runs.
Reading the log
# the interesting lines, without the wall of noise
grep -iE "err|fail|warn" ~/steam-*.log | head -40
# what happened last, right before it died
tail -n 60 ~/steam-*.log
Look for err: lines mentioning vulkan, dxgi,
d3d11 or a missing DLL. A Vulkan error points at the driver (see the
NVIDIA guide); a missing DLL usually means the game needs a
runtime the prefix does not have, which Protontricks can install.
Other launch options worth knowing
| Option | What it does |
|---|---|
gamemoderun %command% | Runs the game through GameMode, which raises the CPU governor and prioritises the game process. Install gamemode first. |
MANGOHUD=1 %command% | Shows a performance overlay: frame rate, frame time graph, GPU and CPU load. Needs mangohud installed. |
PROTON_ENABLE_NVAPI=1 %command% | Enables NVIDIA's NVAPI layer on Proton builds that support it, which some titles need for DLSS. |
DXVK_HUD=fps,frametimes | DXVK's own overlay, useful when MangoHud is not installed. |
WINE_FULLSCREEN_FSR=1 | AMD FidelityFX Super Resolution upscaling for fullscreen games. |
When a game still will not run
- Verify the files. Properties → Installed Files → Verify integrity of game files. Corrupt downloads are more common than people expect.
- Try a different Proton. Proton Experimental, then a numbered release, then GE-Proton if you have installed it.
- Reset the prefix. The Windows environment for each game lives in
~/.steam/steam/steamapps/compatdata/<APPID>/. Rename that folder instead of deleting it, launch the game once, and a fresh prefix is built. Save games stored inside the prefix go with it, so back it up first. - Clear the shader cache. Delete
~/.steam/steam/steamapps/shadercache/to rule out stale compiled shaders. - Ask ProtonDB.
protondb.comhas community reports per game, and usually someone has already hit your exact error.
Useful paths
| Path | What is in it |
|---|---|
~/.steam/steam/steamapps/compatdata/ | One Proton prefix per game, named by app ID. Holds the fake C: drive. |
~/.steam/steam/steamapps/common/ | The installed game files. |
~/.steam/steam/steamapps/shadercache/ | Compiled shaders. Safe to delete. |
~/steam-<APPID>.log | Proton log, created only when PROTON_LOG=1 is set. |
~/.nv/GLCache | NVIDIA shader cache. Safe to delete. |