Linux Troubleshooting Guide + Tips and Solutions

Sections:

  1. Troubleshooting Template
  2. Useful Tips and Tricks
  3. Common Issues + Solutions
  4. FAQ

1. Troubleshooting Template

Here’s a copyable template to fill out when making new topics:

## Issue Description

*YOUR ISSUE HERE*

## System Info

Steam Proton Version:  

Launch Commands: 


CPU: 
GPU: 
If Nvidia-
Driver Type: Official or Nouveau/NVK (open source)

Linux Distro: 
Kernel Version: 
Desktop Environment: 
Display Server/Protocol: 

This template is in a code block to make copying it easy. If you mouse over it there should be a COPY icon that shows up in the corner.

Template Example

Issue Description

Example issue X and Y happens when Z

System Info

Steam Proton Version: ProtonGE 10-34

Launch Commands:
ENABLE_LAYER_MESA_ANTI_LAG=1 PROTON_FSR4_UPGRADE=1 PROTONFIXES_DISABLE=1 %command%

CPU: 7900X
GPU: 9070XT

Linux Distro: Bazzite
Kernel Version: 6.17.7
Desktop Environment: KDE Plasma
Display Server/Protocol: Wayland

How do I find this info?

Proton version and launch commands can be found by right clicking a game in your library and checking the Compatibility and General tabs. Launch commands will be empty unless you’ve put something there before.

If you aren’t forcing a specific version of proton for a game you can check your default in your Steam settings → Compatibility tab. If you’ve never changed it it’s likely Proton Experimental

Distro/etc:
Your system settings likely include a system info/about this system section. If you can’t find it these terminal commands can help.

Kernel version:

uname -rs

Desktop Environment:

echo $DESKTOP_SESSION

Display Server/Protocol:

echo $XDG_SESSION_TYPE

CPU:

lscpu | grep -i name

GPU:

lspci | grep -i vga

Note: CTRL+V may not be the default paste shortcut for terminal. SHIFT+CTRL+V may be the shortcut instead.

Please make a new topic when using this template for help rather than asking for help in this thread. It helps with visibility so you can get help quicker!


2. Useful Tips and Tricks

Alternative Proton Versions

Alternate community made versions of proton are available that add extra functionality on top of Valve’s official proton.

Ex: For Darktide, Proton-GE lets you update DLSS or use FSR4. Proton-GE also has the launcher skip built in if the game doesn’t launch after hitting play.

You can download and update these manually but that can get tiring quick.

Utilities like ProtonPlus (available via Flathub/Bazaar) have an easy to use interface to automate installing and updating these alternate versions of Proton.

FSR4 + DLSS upgrades on Linux

Possible with alternate versions of Proton like Proton-GE (See above tip)

Using GE as an example, you can add these environment variables to your launch commands:

For RDNA4

PROTON_FSR4_UPGRADE=1

For RDNA3 (yes, really!)

PROTON_FSR4_RDNA3_UPGRADE=1

For DLSS

PROTON_DLSS_UPGRADE=1

Darktide does not update it’s UI to show which version of FSR/DLSS you are using so if you want to know it’s working GE has an environment variable for that too

PROTON_FSR4_INDICATOR=1
PROTON_DLSS_INDICATOR=1

Example use case:
This enables FSR4 and adds a HUD watermark so you know it’s working

PROTON_FSR4_UPGRADE=1 PROTON_FSR4_INDICATOR=1 %command%

Make sure to add %command% at the end as that’s the launch command for the game.


3. Common issues + Solutions

Darktide doesn't launch after clicking play

Skipping the launcher may fix this. Proton-GE has the launcher skip built in (See Tips → Proton Versions)

If you want to run the launcher to let the shader cache builder go but don’t want to swap Proton version every time you can disable the launcher skip by putting this in your Darktide launch commands

PROTONFIXES_DISABLE=1 %command%

4. FAQ

TBD


If anyone has useful suggestions to add please leave a comment below :down_arrow:

2 Likes

@FatsharkJulia if this thread could be pinned that would be great :folded_hands: I’d like to make this a reliable first stop for people that need Linux help

2 Likes

Great idea. As a first suggestion, some ways to get the required information could be helpful to less experienced users:

  • Proton version: Right click on the game in your Steam library → Properties → Compatibility
  • Launch Commands: Right click on the game in your Steam library → Properties → General
  • CPU: Via terminal by lscpu | grep -i name
  • GPU: Via terminal by lspci | grep -i vga
  • Kernel version: Via terminal by uname -rs
  • Display Server/Protocol: Via terminal by echo "$XDG_SESSION_TYPE"

Feel free to suggest alternative or better ways to show these or the others that I didn’t address. :slightly_smiling_face:

2 Likes

I was debating adding how to find your system info by going through your settings for some of the common desktop environments but I (really) hope people can find that on their own.

I’m a sucker for a GUI and prefer being able to just click a couple things to find what I need but copyable terminal commands are a painless first terminal experience for people and should work for everyone.

Next up I’ll probably add explanations for why that info is useful (NTSync is a relatively new addition to the kernel, official valve proton doesn’t use NTSync yet last I checked, what even is NTSync, some DEs like Pop_OS COSMIC are newer and could be more prone to issues, etc).

I’ll probably let it be for half a day or so to give time for more suggestions

1 Like

I can totally understand your GUI preference, as I’m a happy KDE Plasma user for about 15 years myself. But as you said, and with the additional complication of Linux’ diverse desktop landscape, terminal commands are arguably the most universal way to retrieve system information. Also, their plain text output can be easily copied and pasted into a forum post (as preformatted text, please).

Thanks for putting my suggestion into your OP, glad I could help!

Note: CTRL+V may not be the default paste shortcut for terminal

Good advice, maybe you could add that SHIFT+CTRL+V may work instead. It does so at least in bash, one of the most common Linux shells. I don’t know anything about others like the Z shell (zsh), though.

1 Like

Also, the middle mouse button pastes marked text without the need of C&P on most Linux desktops. But I don’t know where to stop with these little tips in a mere template guide. :innocent:

(Something that I miss soo dearly on my Windows machine at work. :cry:)

1 Like

Middle click paste is actually one of the first things I turned off, I kept accidentally pasting stuff where I didn’t want to :upside_down_face:

1 Like

Cleaned it up with more collapsible markdown text and added some basic tips + issues

1 Like

Like many things, it’s a matter familiarity and practice. I’m using it about 90% of the time instead of c&p on my Linux desktops, even on my laptop where the middle mouse “button” is a three-fingers-tap on the touch pad :love_you_gesture:. And as I can’t say often enough, I miss it so extremely dearly on my Win PC at work.

So, though I can understand your choice to turn it off, I’d like to dare you to give it another chance sometime, because for me it’s one of the most useful features of Linux desktops. :blush: :folded_hands: Break the chains that Windows shackled you with! :broken_chain: :grin:

1 Like

Nice rework! :+1: