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.


If you need help - 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!


If you are helping others - Be respectful about peoples chosen distro. We all know the reputation about linux users and their “This distro is bad because X” and “This is the only good distro because Y.”

This forum is community lead which means elitism is just going to drive people away. We can’t stop you from sharing your opinions but phrasing it in a polite/helpful way (ex. “You might like Distro X instead because of features Y and Z”) goes a long way towards making people feel more welcome and sticking around.


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%
No settings button in launcher

The launcher is blank on linux and shows no update information or new cosmetics in the background. There’s no settings button either.

If you want to change your number of render threads or toggle IPV6, settings only changeable with the launcher, you must edit your user settings file manually or ideally copy your user settings from a previous Windows install.


4. FAQ

TBD


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

@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

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:

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

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.

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:)

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:

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

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:

Nice rework! :+1:

I wonder what this depends on and if it would be fixable simply by installing a recent version of .NET framework in Darktide’s wine prefix or if there’s more dependencies missing :thinking:

I’ll have to say that I always liked the empty launcher window on Linux, because I don’t care about the flashy advertisements in it on Windows. (Thus I also welcomed its complete removal for other reasons in Proton-GE. :innocent:) But the missing settings button certainly is detrimental, especially for new and/or less tech-savvy players, and a strange effect technically on top of that.

I mostly care less so about it being present/working as I’m curious about how it works as it’s the source of a few headaches on Windows.

Namely there’s this annoying interaction with the AMD Adrenaline app


The launcher bounces between multiple different .exes (even running GPU detection multiple times) and then runs the shader cache builder after starting the game exe if the launcher logs are to be believed.

No other game does this so Adrenaline more often than not points to the wrong .exe so the FSR4 toggle in the overlay shows that it can’t tell if FSR is in use even though it is.

The launcher has a similar effect with nvidia cards where the launcher (I think) can’t run with DLSS updater. Best guess is it’s because the launcher runs GPUDetection.exe multiple times which queries nvidia streamline for feature support. Found that out by deleting the streamline DLLs, they’re required for GPUDetection to work right.

It would be very funny if the game started running worse if the launcher worked properly but surely that can’t be why Windows performance is so cursed.

I’ll get around to messing with Wine prefix stuff soon but how soon is up in the air because I started Balatro and oh man. :melting_face:

Unrelated, I am going to add a reminder to the main post to be polite about people’s distro choice. Already saw one comment about it so best get ahead of all that.