I'm having an issue adding my nvidia gpu. I'm adding it just as it shows in the documentations, and it is identical to how I have Plex set up to use my GPU, which works fine.

When I add --runtime=nvidia it loads the drivers per the log, but I get these errors:
2025-08-05 02:23:53,225 INFO spawned: 'xorg' with pid 426

2025-08-05 02:23:53,272 WARN exited: xorg (exit status 1; not expected)

2025-08-05 02:23:55,234 INFO spawned: 'xorg' with pid 457

2025-08-05 02:23:55,280 WARN exited: xorg (exit status 1; not expected)

2025-08-05 02:23:58,221 INFO spawned: 'xorg' with pid 496

2025-08-05 02:23:58,267 WARN exited: xorg (exit status 1; not expected)

2025-08-05 02:24:01,272 INFO spawned: 'xorg' with pid 538

2025-08-05 02:24:01,320 WARN exited: xorg (exit status 1; not expected)

2025-08-05 02:24:02,321 INFO gave up: xorg entered FATAL state, too many start retries too quickly

When I take out the runtime entry, Steam-headless webUI connects and gives me a login. It has to be that entry, but for whatever reason it is just not working like it's supposed to, and I don't know why.

ok I downgraded my nvidia driver to 570.172.08 (I was on 575.64.03) and it appears to be working now with the GPU runtime added.

I'm not sure what effect this will have on my Plex server transcoding. I will monitor.

Hi there, first of all—really great work with the Docker container! I do have a few questions though.

I tried updating Sunshine, but I couldn’t get the update to install—neither through the store nor via direct download. I also attempted it using a .sh script, but unfortunately that didn’t work either.

Additionally, I’m experiencing an issue where launching Battle.net through Steam or Lutris takes an extremely long time. Does anyone else have this problem? The startup takes about 3 minutes.

Thanks in advance! Also, is another update planned? The last one was back in 2023.

On 8/4/2025 at 12:16 PM, Squirreljester said:

ok I downgraded my nvidia driver to 570.172.08 (I was on 575.64.03) and it appears to be working now with the GPU runtime added.

I'm not sure what effect this will have on my Plex server transcoding. I will monitor.

Just to follow up with this, using this driver made the Steam Headless work perfectly, including adding the options to the docker for it to use the GPU.

Also my Plex server is transcoding super super fast, faster than I can even GPU-Status can even catch the status of most of the time.

I'm having an issue with settings the mnt/user/games folder to mnt/games. When I do this, it does speed everything up significantly as I've seen said in various places, but the vm reports the wrong disk size. It says the max capacity for my disk is 40G (minus all of the other files, so in reality it usually says I have between 15-20G free) instead of the 1TB it is. This only happens when bypassing /user/.

As this is common advice, am I missing something obvious? Do I have to do anything extra? This docker is near unusable when going through FUSE for me. Games don't launch and crazy load times when they actually do.

36 minutes ago, protomayne said:

folder to mnt/games

Is games the name of one of your pools?

I've got this running but whenever I try to open a game it just silently fails.

Log says

INFO reaped unknown pid 6293 (exit status 0)

Different PID but that over and over.

Steam-headless was working fine, then all of a sudden today I get this:

Searching this issue, I found suggestions of several commands to run to install these libraries but I get some sort of permission denied error every time I try. The only change I made to my server was that I changed around the configuration of drives in my cache pool, but I know there wasn't some catastrophic damage to my appdata folder as all 20 other dockers I have installed work fine. The cache was completely 0.00B used of 2TB available when I swapped disks around.

I tried a completely fresh install of steam-headless because my game library is on a separate share that I can just point to at any time, but I got the same error.

I'm new to Steam-Headless. I like the functionality but noticed a couple of things. Hope someone can help me out:

1. Software app is empty - read somewhere that I should do an apt update but that didnt work.

2. Sunshine is out of date - tried installing the latest version from flatpack but that just resulted in 2 installed versions that dont work

3. Lutris cant install to /mnt/games - Installed Lutris through terminal. Changing the install location to /mnt/games installs to /tmp/x11 (or something like that). How do I install to the shared drive?

3 hours ago, ishtangli said:

I'm new to Steam-Headless. I like the functionality but noticed a couple of things. Hope someone can help me out:

1. Software app is empty - read somewhere that I should do an apt update but that didnt work.

2. Sunshine is out of date - tried installing the latest version from flatpack but that just resulted in 2 installed versions that dont work

3. Lutris cant install to /mnt/games - Installed Lutris through terminal. Changing the install location to /mnt/games installs to /tmp/x11 (or something like that). How do I install to the shared drive?

Hi there,

you can fix the permission issue with

flatpak override --user --filesystem=/mnt/games net.lutris.Lutris

but i still got issues with it -.-

to make the config persistant, you have to provide it from your host at docker start. The config is located at

~/.var/app/net.lutris.Lutris/

Regards

17 hours ago, herby88 said:

Hi there,

you can fix the permission issue with

flatpak override --user --filesystem=/mnt/games net.lutris.Lutris

but i still got issues with it -.-

to make the config persistant, you have to provide it from your host at docker start. The config is located at

~/.var/app/net.lutris.Lutris/

Regards

Can you explain more about providing it from the host at start

Has anyone encountered an error like this.....

My sunshine icon constantly blinks, and it was working fine just the other day. I can no longer connect via moonlight because sunshine is constantly starting and stopping repeatedly and filling my logs.

I even installed a new separate container was running into the same error.

Hello,

please do you know if there is a way, how to update Sunshine inside Steamheadless?

7 minutes ago, ELP1 said:

Hello,

please do you know if there is a way, how to update Sunshine inside Steamheadless?

I personally wouldn't recommend it, but the only way I was able to fix my error was to uninstall sunshine via command line, and reinstall it via the software manager.

Now I have to figure out how to get sunshine to auto start with the container lol.

31 minutes ago, Mrtj18 said:

I personally wouldn't recommend it, but the only way I was able to fix my error was to uninstall sunshine via command line, and reinstall it via the software manager.

Now I have to figure out how to get sunshine to auto start with the container lol.

Ok, so I will rather keep it as it is. Thank you.

Is there a trick to getting denuvo games to run? I saw it should be working since 7.1.0 but I’ve never had any luck.

Currently on 7.2.0

Has anyone had any luck with the install-moondeck-buddy script? I've added it to the init.d directory and changed permissions but am met with "Failed to execute user script '/home/default/init.d/install-moondeck-buddy.sh'" every time. I also tried installing the appimage manually but when I launch a game through MoonDeck it only opens Big Picture Mode and then closes out after a short period of time.

Any help would be appreciated! 😁

On 11/9/2025 at 12:28 PM, tadghostal said:

Has anyone had any luck with the install-moondeck-buddy script? I've added it to the init.d directory and changed permissions but am met with "Failed to execute user script '/home/default/init.d/install-moondeck-buddy.sh'" every time. I also tried installing the appimage manually but when I launch a game through MoonDeck it only opens Big Picture Mode and then closes out after a short period of time.

Any help would be appreciated! 😁

I have a steam deck as well, I saw this, but was not 100% sure of the benefits of running this. Have you gotten it too work? If so, what's the benefits?

Since updating to Trixie yesterday, I'm getting various dbus errors and flatpak won't install firefox or other software for that matter. Does anyone else have this issue?

On 12/22/2025 at 4:47 AM, j1mco said:

Since updating to Trixie yesterday, I'm getting various dbus errors and flatpak won't install firefox or other software for that matter. Does anyone else have this issue?

Yep just noticed it today, I'm getting access denied errors. Seems if we are not logged in as root. I'm going to download debain trexie version of Firefox and attempt to install it via command line when logged in as root to see if that fixes the issue

So for me to fix the permission issues. I had to uninstall the docker container. ( Don't delete any appdata data). And reinstalled it from the previous docker apps section from apps on unraid. After that all the weird permission errors are gone, and I have no issue opening anything

Is this still working for anyone after the Debian Trixie update? All of my games that were working before the update no longer launch. When I click on Launch Game in Steam, it acts like it's going to launch and then just cancels back to the Steam client. I've removed and reinstalled the container and even renamed my appdata folder for it just to see if a completely fresh instance would fix it, but no dice.

2 hours ago, chesh said:

Is this still working for anyone after the Debian Trixie update? All of my games that were working before the update no longer launch. When I click on Launch Game in Steam, it acts like it's going to launch and then just cancels back to the Steam client. I've removed and reinstalled the container and even renamed my appdata folder for it just to see if a completely fresh instance would fix it, but no dice.

I've messed with this container recently trying to troubleshoot one game (Monster Hunter Wilds), but I was able to get Monster Hunter World to run, so it still works for playing some games at least.

Hello, i was hoping for a little help.

i cant get steam headless container to have a different refresh rate then 60hz. i bought a hdmi dummy plug and now i can see higher resolutions but cant change the refresh rate.

any help would be greatly appreciated.

Edited February 28Feb 28 by LehmannAD

On 2/28/2026 at 5:34 AM, LehmannAD said:

Hello, i was hoping for a little help.

i cant get steam headless container to have a different refresh rate then 60hz. i bought a hdmi dummy plug and now i can see higher resolutions but cant change the refresh rate.

any help would be greatly appreciated.

I think some of these dummy HDMI adapters are not so good....

Mine are supposed to do 4k 120hrz. Even though I can set it in the panel, in game never gets over 1080p. I think I just have to hook up a real monitor. For it to work correctly.