Skip to content

[Bug]: Steam Installer only launches an invisible window #222

@pugly-tech

Description

@pugly-tech

Describe the Bug

Image Steam doesn't properly launch, only showing a window that reflects what the pixel last saw

Steps to Reproduce

set up folders and compose file, then run docker compose up -d

Expected Behavior

Steam to launch

Screenshots

Image Image Image

Relevant Settings

---

services:
  steam-headless:
    image: josh5/steam-headless:latest
    container_name: steam
    restart: unless-stopped
    shm_size: 2G
    ipc: host # Could also be set to 'shareable'
    ulimits:
      nofile:
        soft: 1024
        hard: 524288
    cap_add:
      - NET_ADMIN
      - SYS_ADMIN
      - SYS_NICE
    security_opt:
      - seccomp:unconfined
      - apparmor:unconfined

    # 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: SteamHeadless
    extra_hosts:
      - "SteamHeadless:127.0.0.1"
    # ENVIRONMENT:
    ## Read all config variables from the .env file
    environment:
      # System
      - TZ=America/Edmonton
      - USER_LOCALES=en_US.UTF-8 UTF-8
      - DISPLAY=:55
      # User
      - PUID=1000
      - PGID=1002
      - UMASK=000
      - USER_PASSWORD=password
      # Mode
      - MODE=primary
      # Web UI
      - WEB_UI_MODE=vnc
      - ENABLE_VNC_AUDIO=true
      - PORT_NOVNC_WEB=8083
      - NEKO_NAT1TO1=192.168.0.2
      # Steam
      - ENABLE_STEAM=true
      - STEAM_ARGS=-silent
      # Sunshine
      - ENABLE_SUNSHINE=true
      - SUNSHINE_USER=graham
      - SUNSHINE_PASS=1234
      # Xorg
      - ENABLE_EVDEV_INPUTS=true
      - FORCE_X11_DUMMY_CONFIG=true
      # Nvidia specific config
      - NVIDIA_DRIVER_CAPABILITIES=all
      - NVIDIA_VISIBLE_DEVICES=all
      - NVIDIA_DRIVER_VERSION=

    # DEVICES:
    devices:
      # Use the host fuse device [REQUIRED].
      - /dev/fuse
      # Add the host uinput device [REQUIRED].
      - /dev/uinput
      # Add AMD/Intel HW accelerated video encoding/decoding devices [REQUIRED].
      # NOTE: See documentation for determining which devices to configure here if you have multiple GPUs
      - /dev/dri/card1
      - /dev/dri/renderD129
    # Ensure container access to devices 13:*
    device_cgroup_rules:
      - 'c 13:* rmw'

    # VOLUMES:
    volumes:
      # The location of your home directory.
      - /mnt/docker/SteamHeadless/home:/home/default:rw

      # The location where all games should be installed.
      # This path needs to be set as a library path in Steam after logging in.
      # Otherwise, Steam will store games in the home directory above.
      - /mnt/games/SteamHeadless/:/mnt/games/:rw

      # The Xorg socket.
      - /mnt/docker/SteamHeadless/sockets/.X11-unix:/tmp/.X11-unix:rw

      # Pulse audio socket.
      - /mnt/docker/SteamHeadless/sockets/pulse:/tmp/pulse:rw

Version

Build: [2026-03-07 03:16:05] [master] [f9836a5] [debian]

Platform

Debian GNU/Linux - 13 (trixie)
6.12.73+deb13-amd64 unknown unknown GNU/Linux
intel GPU
Docker version 29.2.1, build a5c7197
Docker Compose version v5.0.2

Relevant log output

See following comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions