Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Task Reference

All tasks are run with mise run <task>. Run mise tasks to list them.

Build Tasks

All build:* tasks accept --lima to run inside a Lima VM and --vm <name> to specify which VM (default: default).

TaskDescription
checkVerify flake evaluates cleanly (nix flake check)
buildBuild and retain image artifacts under .gcroots/
build:squashfsBuild squashfs rootfs → result-squashfs/
build:rauc-bundleBuild signed RAUC bundle → result-rauc-bundle/
build:boot-scriptBuild U-Boot boot script → result-boot-script/

build also accepts -o <path> to copy the latest .img to a path.

E2E Test Tasks

TaskDescription
e2eRun the core 9-task E2E suite sequentially
e2e:rauc-slotsRAUC slot detection after boot
e2e:rauc-updateBundle install + slot switch A→B
e2e:rauc-rollbackInstall → mark bad → rollback to previous slot
e2e:rauc-confirmos-verification health check → mark-good (~3 min)
e2e:rauc-power-lossCrash mid-install, verify recovery
e2e:rauc-watchdogWatchdog + boot-count rollback
e2e:firewallWAN/LAN/VPN port allow/deny (2-node VLAN)
e2e:network-isolationDHCP/NTP/WAN isolation (2-node VLAN)
e2e:ssh-wan-toggleSSH-on-WAN flag enable/disable
e2e:debugInteractive QEMU VM for debugging (-t <test>, --keep)

Provisioning Tasks

TaskDescription
flashFlash image to disk device with dd + progress (macOS/Linux)

Configuration Tasks

config:lan-range: Update LAN gateway/DHCP range across all config files.

Utility Tasks

TaskDescription
gcDelete old generations and collect unrooted store paths (--lima; --vm <name> when using --lima)
serial:captureCapture serial output (1.5 Mbaud, auto-reconnect). --bg for background
serial:shellInteractive serial shell via minicom (1.5 Mbaud)