This is an old revision of the document!
Table of Contents
OS Choice and Setup
The OS choice is supposedly pretty open here. Many vendors provide ROMs and packages and support for ARM-based boards. However at the time, Q1 2026, there is a lack of support for the CM5 board, and especially the 16GB version which needs a bit more love and care than other models.
Considerations
While trying to find an OS for this, I went through many options one by one trying to find the most fitting one, aka something at least stable and supported, and also customizable.
A couple adventures
The first choice I tried was PiOS, not because it's my favorite but mostly because I wanted to make sure the board worked. The installation was pretty straight-forward, and we'll go through it later in this page, and the device is fully supported in that context.
Once the board was tested as a working unit, I wanted to install a more fun distro, thinking about getting Fedora to run on there. After numerous hours of trying to run it, getting through the little quirks that can happen with the OneUp + CM5 16GB combo, it did not work. The device would boot but show up errors on there. The main culprit ? The lack of support from Fedora, which has some issues integrating the new CM5's hardware into the Fedora build.
So I abandoned this way, and tried to install Thumbleweed, from OpenSUSE. This distro supposedly had support for Pi-boards as well as some other amd64 integrated boards. After reviewing many of the installation media from the website (that is a pain to go around) and trying to find a raw file for ARM64, I couldn't find any. It would have been a pretty solid choice, considering it's stable while having new-ish packages officially supported.
I also tried to get Void working but without any knowledge of this specific distro I could not really go through the documentation as swiftly and comfortably as I wanted, so I left that choice on the side.
Final Choice
Considering the fact that other OSs are not yet mature enough for the CM5 16GB, I will chose to use PiOS Lite. In order to get something customizable enough, I will have to modify it a little, and try to have APT and Nix work together to make this build work.
In fine, APT will be used for the system packages, while Nix for userland.
Installation
To install the OS on the Pi's eMMC, you absolutely need another computer. I used my trusted Debian laptop, flipped the switch on the OneUp so the CM5 would be in the right mode, and then I wired the two laptop casings together as shown in the documentation.
Software requirements for installation
In order to flash the OS onto the eMMC (would work for the NVME too), you will first need a little tool so that your installation laptop sees and can mount the storage devices from the Pi.
