Build custom ISO images for Nix using github actions

Easy to create, custom ISO images for NixOS starting with raspberry pi.

The idea is to create a simple ISO image with some presets, then use something like deploy-rs to update the raspis.

If you need to build a quick raspi custom image using nixos, this repo is for you. It also works well if you want to experiment with nixos.

An alternative, and more advanced approach, is to create a nixos image for your raspberry, with the most basic features, and then, use something like deploy-rs or bento to update and configure your raspberries.

1. Fork this repo
2. Go to the github actions section
3. Click on "Build ISO"
4. Trigger the workflow with the inputs you want to customize
5. Wait
6. Download the ISO
7. Flash it

When you fork the repo, you can custommize the ganix.nix file, and you won't need to provide the env variables for the github action

nix flake check --impure

Supported arch aarch64-linux

nix build

Plug sd-card.

Find out USB's location.

(output e.g: /dev/disk2)

Check that the SD is unmounted

Burn the .img to the sd-card

sudo dd if=result/nixos-sd-image-23.05.20230326.0cd51a9-aarch64-linux.img of=/dev/disk2 bs=1m status=progress

Remember to download the img and unzip it from the github action.

Good luck!

Take a look at nixos configuration.