dosbox-staging

v0.83.0-ls46

DOSBox Staging is a modern continuation of DOSBox a free and open-source emulator that enables the execution of MS-DOS software, especially video games.

Games

docker pull lscr.io/linuxserver/dosbox-staging:latest

Quick start

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

---
services:
  dosbox-staging:
    image: lscr.io/linuxserver/dosbox-staging:latest
    container_name: dosbox-staging
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    shm_size: 1gb
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
3000:3000	DOSBox Staging desktop gui HTTP, must be proxied.	required
3001:3001	DOSBox Staging desktop gui HTTPS.	required

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required

Volumes
Path	Function	Required
/config	Users home directory in the container, stores program settings and files.	required

Other settings
Setting	Function	Required
shm_size: 1gb	Recommended for all desktop images.	required

Architectures

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

x86_64latest

Changelog

5 Mar 2026
Make Wayland default disable with PIXELFLUX_WAYLAND=false.
28 Dec 2025
Add Wayland init logic.
30 Aug 2025
Initial release.

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