raspios-docker

Automated multi-architecture builds of Raspberry Pi OS Docker images.

This project builds container images based on official Raspberry Pi OS Lite root filesystems (32-bit and 64-bit variants) and publishes them to Docker Hub: https://hub.docker.com/r/vascoguita/raspios.

Docker Images 🐳

Tag	Architectures	Description
arm64	arm64	Image with the latest 64-bit Raspberry Pi OS Lite release
armhf	arm/v6, arm/v7, arm64	Image with the latest 32-bit Raspberry Pi OS Lite release
arm64-YYYYMMDD	arm64	Image with the 64-bit Raspberry Pi OS Lite release of YYYY-MM-DD
armhf-YYYYMMDD	arm/v6, arm/v7, arm64	Image with the 32-bit Raspberry Pi OS Lite release of YYYY-MM-DD

Note

• arm64 and armhf are rolling tags that always point to the latest available image for that variant.
• *-YYYYMMDD tags are immutable and built from the official Raspberry Pi OS Lite root filesystems published on that specific date. These will never change, ensuring reproducibility.

View on Docker Hub: https://hub.docker.com/r/vascoguita/raspios

Usage 💡

Use these images as a base for Raspberry Pi-specific containers:

FROM vascoguita/raspios:arm64

# Add your own layers here

Or run directly:

docker run --rm -it --platform linux/arm64 vascoguita/raspios:arm64

Note for x86_64 Hosts

If you're running this image on an x86_64 (Intel/AMD) machine, you will need to enable emulation via QEMU to run ARM containers.

Dependencies for Emulation 🔧

To run arm64 or armhf containers on x86_64 hosts, install QEMU and enable binfmt support using your system's package manager.

• Debian/Ubuntu:

  sudo apt install qemu-user-static binfmt-support

• Fedora:

  sudo dnf install qemu-user-static binfmt-support

• Arch Linux:

  sudo pacman -S qemu-user-static binfmt-support

License 📝

This project is licensed under the MIT License.

Code of Conduct 📜

Please review our Code of Conduct to understand the expectations for behavior within the project community.

Security Policy 🔒

For information on our security policy and reporting vulnerabilities, please check our Security Policy.

Contributing Guidelines 🚀

We welcome contributions! Before getting started, please read our Contributing Guidelines for information on how to contribute to the project.