steamos

2025-07-12-ls96deprecated

SteamOS is an Arch based Linux distribution made by Valve Software. This container is a vanilla Arch install with Steam repositories added for software support. **This container will only work with modern AMD/Intel GPUs on a real Linux Host**

Games

docker pull lscr.io/linuxserver/steamos:latest

This image is deprecated

It is no longer maintained and receives no further updates. The details below are kept for reference; you can find maintained alternatives in the catalogue.

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

Include optional settings

---
services:
  steamos:
    image: lscr.io/linuxserver/steamos:latest
    container_name: steamos
    hostname: hostname # optional
    cap_add:
      - NET_ADMIN
    security_opt:
      - seccomp:unconfined
      - apparmor:unconfined # optional
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - TZ=Europe/London
      - DRINODE=/dev/dri/renderD128
      - HOST_IP=192.168.100.10 # optional
      - STARTUP=KDE # optional
      - RESOLUTION=1920x1080 # optional
    volumes:
      - /path/to/config:/config
      - /dev/input:/dev/input # optional
      - /run/udev/data:/run/udev/data # optional
    ports:
      - 3000:3000
      - 3001:3001
      - 27031-27036:27031-27036/udp # optional
      - 27031-27036:27031-27036 # optional
      - 47984-47990:47984-47990 # optional
      - 48010-48010:48010-48010 # optional
      - 47998-48000:47998-48000/udp # optional
    devices:
      - /dev/dri:/dev/dri
    shm_size: 1gb
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
3000:3000	SteamOS desktop gui.	required
3001:3001	HTTPS SteamOS desktop gui.	required
27031-27036:27031-27036/udp	Steam Remote Play Ports (UDP).	optional
27031-27036:27031-27036	Steam Remote Play Ports (TCP).	optional
47984-47990:47984-47990	Sunshine Ports (TCP).	optional
48010-48010:48010-48010	Sunshine Ports (TCP).	optional
47998-48000:47998-48000/udp	Sunshine Ports (UDP).	optional

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required
TZ=Europe/London	Specify a timezone to use EG Europe/London.	required
DRINODE=/dev/dri/renderD128	Specify the render device (GPU) for the contianer to use.	required
HOST_IP=192.168.100.10	Specify the IP of the host, needed for LAN Remote Play.	optional
STARTUP=KDE	KDE to boot into desktop mode, BIGPICTURE to boot into gamescope.	optional
RESOLUTION=1920x1080	When booting into BIGPICTURE mode the screen resolution will be bound to this value.	optional

Volumes
Path	Function	Required
/config	Users home directory in the container, stores all files and games.	required
/dev/input	Optional for gamepad support. *Only working for Steam Remote Play	optional
/run/udev/data	Optional for gamepad support. *Only working for Steam Remote Play	optional

Devices
Device	Function	Required
/dev/dri	Video card passthrough to Steam.	required

Other settings
Setting	Function	Required
cap_add: NET_ADMIN		required
security_opt: seccomp:unconfined	This is needed to allow kernel syscalls made by Steam.	required
security_opt: apparmor:unconfined	For Debian/Ubuntu hosts Steam needs elevated perms that AppArmor blocks.	optional
shm_size: 1gb	This is needed for the steam browser to function properly.	required
hostname: hostname	Specify the hostname of the host, this is useful for keeping a persistent hostname between upgrades and identifying the server in the remote play Steam Client.	optional

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64latest

Changelog

9 Dec 2025
Deprecate container, any future release will be for the Steam application not the underlying OS.
23 May 2024
Document how to get Nvidia to work.
15 Jan 2024
Install gperftools to fix source games.

Browse all

dolphin

2609a-ls87

Dolphin Emulator lets you play GameCube and Wii games with various graphical enhancements and other features are available to improve your game experience.

2.8M13

webstation

ceb22cc0-ls41

Webstation is a web native emulation focused LXQt desktop based on Ubuntu.

78.6K15

luanti

5.18.0-rc1-ls50

luanti (formerly Minetest) is an open source voxel game-creation platform with easy modding and game creation

36.1K15arm64

steam

95181c2e-ls45

Steam is the ultimate destination for playing, discussing, and creating games.

21.4K36