linuxserver/qemu-static repository overview

The LinuxServer.io⁠ team brings you another container release featuring :-

• regular and timely application updates
• easy user mappings (PGID, PUID)
• custom base image with s6 overlay
• weekly base OS updates with common layers across the entire LinuxServer.io ecosystem to minimise space usage, down time and bandwidth
• regular security updates

Find us at:

• Blog⁠ - all the things you can do with our containers including How-To guides, opinions and much more!
• Discord⁠ - realtime support / chat with the community and the team.
• Discourse⁠ - post on our community forum.
• Fleet⁠ - an online web interface which displays all of our maintained images.
• Open Collective⁠ - please consider helping us by either donating or contributing to our budget

QEMU Static⁠ - Run multiple architectures of Docker containers on an x86_64 or aarch64 host using QEMU static.

⁠Supported Architectures

We utilise the docker manifest for multi-platform awareness. More information is available from docker here⁠ and our announcement here⁠.

Simply pulling lscr.io/linuxserver/qemu-static:latest should retrieve the correct image for your arch, but you can also pull specific arch images via tags.

The architectures supported by this image are:

⁠Usage

Unlike most of our container library this image is meant to be run ephemerally from the command line to enable the underlying host to run containers built for different architechtures. Changes will not persist a host reboot.

⁠Enable and reset

docker run --rm -it \
  --privileged \
  linuxserver/qemu-static \
  --reset \
  -p yes

⁠Versions

• 17.11.25: - Use Debian Trixie for build.
• 09.12.24: - Upgrade to 9.1.2, automate new builds.
• 07.11.24: - Upgrade to 9.1.1, switch to new debian package and bin naming scheme.
• 14.10.24: - Initial release.