Home

CustomPiOS Wiki

CustomPiOS is a framework for creating custom Raspberry Pi and ARM device distributions. It takes an existing base image, modifies it through modular scripts, and repackages it ready to ship.

Build and release

• Base and Module Configuration - New! Comprehensive reference for all 81+ configuration variables across 15 modules
• Building
• Building with Docker
• Building with Vagrant
• Releasing with Github Actions - New! Complete guide for automated releases with GitVersion and Raspberry Pi Imager integration

Extending distributions with features

• Modules

Testing your distributions without a Pi

CustomPiOS Distro Testing Framework - CustomPiOS has an e2e Distro Testing Framework. It lets you tests arm64 images autocratically using CI/CD without booting a pi. See the READNME.md in the project to see how it works and how to use it.

Advanced

• Common.sh functions
• Creating a snipplet to add to rpi imager
• CustomPiOS internals

Frequently Asked Questions

• FAQ