Truenas Scale install steps?

[TheSilasm8]

Description

Can we get some documentation on how to set this up for truenas scale?

I found this from the Truenas Discover Apps section, but it doesn't seem to be easy to set up. Much my frustration is likely due to my inexperience with some of the technical details here, but still.

1. The app configuration in Truenas does not have any explanation. I'm familiar with network config and storage config from setting up other apps, but I'm not familiar with Display...

or SHM Size or Mode, etc. Why not just explain this in the help tooltip?

2. After some googling, starting the app and connecting via VNC does not show the Steam application anywhere. After more googling, this seems to be Xvfb not working properly? I tried fixing this with even more googling and chatgpt input, but I think I'm stuck. I can't get Steam to display no matter what even though I know it's running, so I can't log in or even download games.

[lxr3517]

Hi, I am unsure if this will help you, but my issue was fixed with these steps.

First, Force Nvidia CUDA_VISIBLE_DEVICES =1 or whatever your GPU is.

Second, make sure your Nvidia GPU is enabled

On System Launch CPU-X

then on the little wrech click it

change it to your GPU

Only then was I able to launch Steam

Solution 2:

first install headless, make sure to anable GPU, then open the Shell and get the Adapter name:

ls -l /dev/dri

mine was /dev/dri/renderD129

Then launch the app and Load Sunshine go to auio and video and paste the adapter name there.. Make sure to save

Forgot to mention to make sure! you are pushing the right x11 if not force it
Force X11 Dummy Config

My YALM for Scale

services:
steam-headless:
cap_add:
- AUDIT_WRITE
- CHOWN
- DAC_OVERRIDE
- FOWNER
- FSETID
- KILL
- MKNOD
- NET_ADMIN
- SETGID
- SETUID
- SYS_ADMIN
- SYS_NICE
- SYS_RESOURCE
cap_drop:
- ALL
container_name: steam
devices:
- /dev/dri:/dev/dri
- /dev/nvidia0:/dev/nvidia0
- /dev/nvidiactl:/dev/nvidiactl
- /dev/nvidia-uvm:/dev/nvidia-uvm
- /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
environment:
DISPLAY: ':0'
ENABLE_STEAM: 'true'
ENABLE_SUNSHINE: 'true'
FORCE_X11_DUMMY_CONFIG: 'true'
GID: '568'
GROUP_ID: '568'
HOST_DBUS: 'true'
MODE: primary
NVIDIA_DRIVER_CAPABILITIES: all
NVIDIA_VISIBLE_DEVICES: GPU-ID here
PGID: '568'
PORT_NOVNC_WEB: '31100'
PUID: '568'
STEAM_ARGS: '-silent'
SUNSHINE_PASS: passwordhere
SUNSHINE_PREFER_NVIDIA: '1'
SUNSHINE_USER: steam-headless
TZ: America/Los_Angeles
UID: '568'
UMASK: '002'
UMASK_SET: '002'
USER_ID: '568'
USER_PASSWORD: passwordhere
XDG_RUNTIME_DIR: /tmp/.X11-unix/run
XDG_SESSION_TYPE: x11
extra_hosts:
steam-headless: 127.0.0.1
group_add:
- 44
- 107
- 568
image: josh5/steam-headless:debian
ipc: host
network_mode: host
platform: linux/amd64
privileged: True
restart: unless-stopped
security_opt:
- apparmor=unconfined
- seccomp=unconfined
shm_size: 2048M
user: root
volumes:
- /mnt/Cloud/Main/Apps/steam/home:/home/default
- /mnt/Cloud/Main/Apps/steam/games:/mnt/games
- /run/dbus:/run/dbus:ro
- /mnt/Cloud/Main/Apps/steam/pulse:/tmp/pulse
volumes: {}
x-portals:

• host: 0.0.0.0
  name: Web UI
  path: /
  port: 31100
  scheme: http

[MingyaoLiu]

I configured it to what you said, and I can run nvidia-smi in the steam headless 'terminal' and see rtx3090, in cpu-x i can see my intel integrated card and rtx3090.
However my steam doesn't launch, and sunshine report error (also couldn't connect to it).

Here is the sunshine log:

[socratesprime]

I am experiencing the same issue as the OP. Everything was working perfectly on TrueNAS Electric Eel. About a week ago, I upgraded to 25.10.0.1 (Goldeye), and when I tried again today, Moonlight no longer works, Steam will not launch, and I receive the error shown below.

I can’t say with absolute certainty that the Goldeye update is the cause, but I am 100% certain that the setup was functioning correctly prior to the upgrade. The update from Electric Eel to Goldeye is the only significant change since I last used Moonlight (Steam-Headless) successfully.

Host returned error: Failed to initialize video capture/encoding. Is a
display connected and turned on? (Error 503)

[samdoesknow]

I am experiencing the same issue as the OP. Everything was working perfectly on TrueNAS Electric Eel. About a week ago, I upgraded to 25.10.0.1 (Goldeye), and when I tried again today, Moonlight no longer works, Steam will not launch, and I receive the error shown below.

I can’t say with absolute certainty that the Goldeye update is the cause, but I am 100% certain that the setup was functioning correctly prior to the upgrade. The update from Electric Eel to Goldeye is the only significant change since I last used Moonlight (Steam-Headless) successfully.

Host returned error: Failed to initialize video capture/encoding. Is a
display connected and turned on? (Error 503)

https://github.com/zzzhouuu/truenas-nvidia-drivers

do you have a legacy gpu and need older kernal driver? just so you know im using this and it still doesnt work.

[samdoesknow]

Welp, besides moonlight being pure shit on my pc. its fixed, i installed electirc eel instead of goldeneye and it uses 550 driver and atleast thru vnc on 2.4ghz (cable disconnected atm) it runs games.

Edit: Ok holy cow, were back to gaming, just needed proton 8 for controller. input isnt bad at all and thats with a hdd pool need to fix that. deadcells playable, just example for latency.

[TheSilasm8]

I'm currently on Fangtooth 25.04 trying to run a gtx 1080.

I deleted and reinstalled the app.

Set CUDA_VISIBLE_DEVICES to 0 to match my GPU index. I can see the GPU from within CPU-X.

But I'm seeing the same problems as MingyaoLiu. Sunshine can't find the display and Steam won't launch.

[socratesprime]

Based on the issues described, it is pretty clear that Steam Headless is having an issue with the new Nvidia driver: 570.172.08.

At the very least, that seems to be the case for TrueNAS SCALE, as reverting to an older version of the OS with older Nvidia drivers seems to get Steam running in the Docker container. Is the maintainer watching this issue? Any input as to how this issue could be resolved in a future release?

[samdoesknow]

Based on the issues described, it is pretty clear that Steam Headless is having an issue with the new Nvidia driver: 570.172.08.

At the very least, that seems to be the case for TrueNAS SCALE, as reverting to an older version of the OS with older Nvidia drivers seems to get Steam running in the Docker container. Is the maintainer watching this issue? Any input as to how this issue could be resolved in a future release?

Nothing maintainer can/will do they dropped pascal gpus in nvidia support

[socratesprime]

Based on the issues described, it is pretty clear that Steam Headless is having an issue with the new Nvidia driver: 570.172.08.
At the very least, that seems to be the case for TrueNAS SCALE, as reverting to an older version of the OS with older Nvidia drivers seems to get Steam running in the Docker container. Is the maintainer watching this issue? Any input as to how this issue could be resolved in a future release?

Nothing maintainer can/will do they dropped pascal gpus in nvidia support

I use an RTX 3090. It is supported by the new drivers. Steam Headless is unable to load Steam with the new 570.172.08 drivers. This should qualify as a bug and hence warrant the attention of developers or the maintainer.

[samdoesknow]

Based on the issues described, it is pretty clear that Steam Headless is having an issue with the new Nvidia driver: 570.172.08.
At the very least, that seems to be the case for TrueNAS SCALE, as reverting to an older version of the OS with older Nvidia drivers seems to get Steam running in the Docker container. Is the maintainer watching this issue? Any input as to how this issue could be resolved in a future release?

Nothing maintainer can/will do they dropped pascal gpus in nvidia support

I use an RTX 3090. It is supported by the new drivers. Steam Headless is unable to load Steam with the new 570.172.08 drivers. This should qualify as a bug and hence warrant the attention of developers or the maintainer.

Ya my b dont know how to double qutoe here, was mostly for the dude above that said 1080 device.

[TheSilasm8]

Isn't Pascal support only dropped in 25.10? I'm running 25.04 and driver version 550.142.

[MingyaoLiu]

Made some small progress
I passed through my intel integrated GPU and my RTX at the same time to steam headless on truenas scale 25.10, sunshine would work fine but only with intel encoder, nvidia-smi still work fine but steam doesn't launch.
Force sunshine to use NVFBC would break it.
Very interesting is when using moonlight with both intel and nvidia passed through, moonlight would stream my host display, not the steam headless display. I would see all the serial message from my truenas.

Passing through only intel integrated graphic:
if use dummy x11 profile -> moonlight still streams the truenas serial display
if use :99 -> moonlight streams correct desktop (same as vnc)

everything else works, steam launch fine, i could launch super meat boy and it runs on 10 fps , couldn't launch slay the spire, game crash and also sunshine crash, maybe the shared vram of intel graphic got suffocated.

i tried using secondary mode, and it cause kernel panic on truenas:

libX11.so.6.4.0[31692,f659b000+92000] likely on CPU 2 (core 4, socket 0)
Jan 13 11:54:51 mothership kernel: Code: 89 44 24 3c 31 c0 85 ed 0f 84 e2 00 00 00 83 ec 0c 55 e8 c1 1f fe ff 83 c4 10 89 c2 31 c0 81 fa fe ff 00 00 0f 87 ac 00 00 00 <8b> 86 d0 04 00 00 85 c0 0f 84 e8 00 00 00 83 ec 0c 56 ff 10 83 c4
Jan 13 11:54:54 mothership kernel: steam[230525]: segfault at 4d0 ip 00000000f65ba692 sp 00000000ffe4c570 error 4 in libX11.so.6.4.0[31692,f659b000+92000] likely on CPU 4 (core 8, socket 0)
Jan 13 11:54:54 mothership kernel: Code: 89 44 24 3c 31 c0 85 ed 0f 84 e2 00 00 00 83 ec 0c 55 e8 c1 1f fe ff 83 c4 10 89 c2 31 c0 81 fa fe ff 00 00 0f 87 ac 00 00 00 <8b> 86 d0 04 00 00 85 c0 0f 84 e8 00 00 00 83 ec 0c 56 ff 10 83 c4
Jan 13 11:54:58 mothership kernel: steam[230757]: segfault at 4d0 ip 00000000f65ba692 sp 00000000ffb936c0 error 4 in libX11.so.6.4.0[31692,f659b000+92000] likely on CPU 6 (core 12, socket 0)
Jan 13 11:54:58 mothership kernel: Code: 89 44 24 3c 31 c0 85 ed 0f 84 e2 00 00 00 83 ec 0c 55 e8 c1 1f fe ff 83 c4 10 89 c2 31 c0 81 fa fe ff 00 00 0f 87 ac 00 00 00 <8b> 86 d0 04 00 00 85 c0 0f 84 e8 00 00 00 83 ec 0c 56 ff 10 83 c4

So basically it works fine on intel but enabling nvidia will make it not able to find the right display and sunshine no longer able to encode correctly.

i have a hdmi decoy plugged into the rtx3090, maybe that's causing this? I will try remove it when im back from work

[MingyaoLiu]

nvm i just got it working, following this guide: #200 (comment)

here is my portainer setup:

---
services:
  steam-headless_new:  # change the name to what you want
    image: josh5/steam-headless:latest
    restart: unless-stopped
    ## NOTE: This config uses privileged to access to host to be able to access the required devices
    privileged: true
    runtime: nvidia
    container_name: Steam-Headless_NEW  # change the name to what you want
    shm_size: 6G
    ipc: host # Could also be set to 'shareable'
    ulimits:
      nofile:
        soft: 1024
        hard: 524288
    extra_hosts:
      - "Steam-Headless_NEW:127.0.0.1" # change the name to match container/hostname
    
    # NETWORK:
    ## NOTE:  With this configuration, if we do not use the host network, then physical device input
    ##        is not possible and your USB connected controllers will not work in steam games.
    network_mode: host
    hostname: Steam-Headless_NEW  # change the name to what you want

    ports:
      - 8086:8086
    
    # ENVIRONMENT:
    ## Read all config variables from the .env file
    environment:
      # System
      - TZ=America/Toronto
      - USER_LOCALES=en_US.UTF-8 UTF-8
      - DISPLAY=:55
      # User
      - PUID=568  # 99 for unraid / or what ever user for the OS you're using
      - PGID=568  # 100 for unraid / or what ever user for the OS you're using
#      - UMASK=
      - USER_PASSWORD=something #what ever password you want to use, not sure what it's used for
      # Mode
      - MODE=primary
      # Web UI
      - WEB_UI_MODE=vnc
      - ENABLE_VNC_AUDIO=false
      - PORT_NOVNC_WEB=8086
      # Nvidia specific config
      - NVIDIA_DRIVER_CAPABILITIES=all
      - NVIDIA_VISIBLE_DEVICES=all   #or what ever GPU ID you want to use
      - NVIDIA_DRIVER_VERSION=  # I left this blank to use what was the base server drivers.

    # VOLUMES:
    volumes:
      - /mnt/Mirror3TB/steamheadless/:/home/default
      - /mnt/Mirror3TB/steamlibrary/:/mnt/games
     
      - /tmp/.X11-unix/:/tmp/.X11-unix/
      - /tmp/tmp/pulse/:/tmp/tmp/pulse/
      - /dev/input/:/dev/input/