Installing NixOS, ZFS, and LUKS on the PiBox

Howdy! I recently wrote up a guide on installing NixOS on the PiBox, a RaspberryPi Compute Module 4 enclosure which comes with a PWM fan, an LCD, and two SATA SSD bays.

The guide walks through how to configure LUKS and ZFS along with installing NixOS. It also includes support for the hardware peripherals and packages the systemd services to manage them! The implementation for the hardware specifics can be found in this repo for anyone curious.

Hope it’s useful!


I’ve had one of these for a few months now and I’ve been meaning to put NixOS on it - Thanks for write up!


It took me a while to get the hardware working (had to take nice tour of device tree blobs and how their overlays work!) so the guide was written from the notes I had taken much after the fact. If anything seems incorrect or not quite working feel free to let me know and I’ll try to correct things!

1 Like
Hosted by Flying Circus.