starxen/raspios repository overview

⁠Raspberry Pi OS

Docker base image built directly from the official Raspberry Pi OS Lite images, for use as a FROM base in downstream Dockerfiles or as a lightweight RPi-flavored shell environment.

⁠Quick reference

Maintained by:

• StarXen GitLab Repository⁠

Where to get help: the Docker Community Slack⁠, Server Fault⁠, Unix & Linux⁠, or Stack Overflow⁠

Where to file issues: https://gitlab.com/starxen/raspios-docker-image/-/issues⁠

Supported architectures: (more info⁠) arm32/v6 arm64

Build Process Source Codes: You can find the source code for the build process at: GitLab Repository⁠

Published Image Artifact Details:

• GitLab Pipelines Log⁠ — Contains the full build history.
• Builds are triggered by new Tags⁠

⁠What is Raspberry Pi OS?

Raspberry Pi OS is the Debian-based operating system maintained by the Raspberry Pi Foundation for Raspberry Pi hardware. This image is built directly from the official raspios_lite .img releases — no re-packaging, no third-party rootfs — with only the packages that cannot function inside a container (kernel, initramfs, bootloader) removed, plus a small set of desktop/multimedia/wireless-firmware packages that are dead weight in a headless container.

⁠Supported Tags and Respective Dockerfile Links

• starxen/raspios:latest⁠
• starxen/raspios:lite⁠
• starxen/raspios:trixie⁠
• starxen/raspios:trixie-lite⁠
• starxen/raspios:YYYY-MM-DD⁠
• starxen/raspios:YYYY-MM-DD-lite⁠
• starxen/raspios:YYYY-MM-DD-trixie⁠
• starxen/raspios:YYYY-MM-DD-trixie-lite⁠

Every tag is a multi-platform manifest list covering both linux/arm/v6 and linux/arm64 — docker pull/docker run automatically selects the right one for the host, and both can also be selected explicitly with --platform.

⁠Version tag policy

Docker image tags follow the release date published by the Raspberry Pi Foundation, e.g. 2026-06-19 — the same timestamp that appears in the raspios_lite_{armhf,arm64}-YYYY-MM-DD download URL. The dateless tags (latest, lite, trixie, trixie-lite) always point at the most recently built release date; the dated tags (YYYY-MM-DD*) are kept around for reference and never overwritten.

⁠How to use this image

⁠Run a shell

docker run --rm -it starxen/raspios bash

⁠Pick a specific architecture

docker run --rm -it --platform linux/arm64 starxen/raspios bash
docker run --rm -it --platform linux/arm/v6 -e QEMU_CPU=arm1176 starxen/raspios bash

QEMU_CPU=arm1176 forces genuine ARMv6 (Pi 1/Zero) emulation instead of QEMU's default ARMv7 model when running the arm32/v6 variant under emulation on non-ARM hosts.

⁠Use as a base image

FROM starxen/raspios:trixie
RUN apt-get update && apt-get install -y --no-install-recommends your-package && rm -rf /var/lib/apt/lists/*

apt-get install/apt-get upgrade work normally inside the container — the packages that would otherwise break under emulation (kernel, initramfs-tools, bootloader) are already removed from the image.

⁠Environment Variables

The image provides the following environment variables:

• IMAGE_ARCH: Image architecture, either ARM32V6 or ARM64.
• RASPIOS_RELEASE_DATE: Upstream Raspberry Pi OS release date this image was built from.
• RASPIOS_CODENAME: Debian codename of the underlying release, e.g. TRIXIE.

⁠License

Raspberry Pi OS is released by the Raspberry Pi Foundation under its own licensing terms⁠. This project only automates downloading, extracting and trimming the official images — no modification of package contents.

⁠More Information

• Raspberry Pi OS⁠
• Docker Hub Repository⁠
• GitLab Image Build Repository⁠

⁠Backers

• laserovsky.net⁠ for hosting GitLab Runners used for building and publishing Docker images.