Files
start-os/build/image-recipe
Aiden McClelland dba1cb93c1 feat: raspberry pi U-Boot + GPT + btrfs boot chain
Switch Raspberry Pi builds from proprietary firmware direct-boot to a
firmware → U-Boot → GRUB → kernel chain using GPT partitioning:

- GPT partition layout with fixed UUIDs matching os_install: firmware
  (128MB), ESP (100MB), boot (2GB FAT32), root (btrfs)
- U-Boot as the kernel in config.txt, chainloading GRUB EFI
- Pi-specific GRUB config overrides (console, USB quirks, cgroup)
- Btrfs root with shrink-to-minimum for image compression
- init_resize.sh updated for GPT (sgdisk -e) and btrfs resize
- Removed os-partitions from config.yaml (now derived from fstab)
2026-03-12 11:12:04 -06:00
..
2025-12-22 13:39:38 -07:00

StartOS Image Recipes

Code and debos recipes that are used to create the StartOS live and installer images.

If you want to build a local image in the exact same environment used to build official StartOS images, you can use the run-local-build.sh helper script:

# Prerequisites
sudo apt-get install -y debspawn binfmt-support
sudo mkdir -p /etc/debspawn/ && echo "AllowUnsafePermissions=true" | sudo tee /etc/debspawn/global.toml

# Build image
./run-local-build.sh

In order for the build to work properly, you will need debspawn >= 0.5.1, the build may fail with prior versions.