Docs: Boot & Finish

AcornOS documentation

Boot & Finish

Installation steps 15-17. Required, whichever way you did the earlier parts: the helper apps do not do this. Run it in the live terminal, with the new system's root at /mnt and its EFI partition at /mnt/boot.

What Installed Means

Warning
Not installed yet. Copying the system and configuring it leaves a disk the firmware cannot boot. The installation is complete only when the boot files and boot entries exist on the EFI partition and the verification has passed. The Boot step below writes them and shows its progress and its result in the terminal; the Finish step comes after a passing result. Do not reboot before then.

15. Review Services

Note
Optional. Nothing here is needed to finish; read it if you want another service started at boot.

The network group recipe, installed with the default software, starts networkmanager at boot. Live-session autologin and shell overrides stay on the ISO.

Inspect installed services and other choices
recsetup inspect --root /mnt --json

Start another installed service at boot with recsetup apply --root /mnt --service SERVICE.

WiFi: keep the networks saved in the live session
cp -a /etc/NetworkManager/system-connections/. /mnt/etc/NetworkManager/system-connections/

16. Install the Boot Loader and Entries

Required. Use the root A and B devices reported by recpart apply (or by disk-plan). Previewing with recsetup plan runs no installation commands. The command prints a line as each step starts (recsetup: step N/M: ...), ends with Completed N setup steps. when the boot files and entries are written, and on A/B then runs the verification, which ends with verify-installation: PASSED. Any other ending, FAILED or an error, means the system is not installed: fix the cause and run the same command again.

Make root B a copy of root A and write both boot entries
recsetup apply --root /mnt --boot ab --slot-a /dev/nvme0n1p2 --slot-b /dev/nvme0n1p3 --machine-id && recab verify-installation --root /mnt

recsetup calls recab init, which copies the target's systemd-boot EFI binary and writes the boot layout. It copies root A to root B, writes both boot entries and makes A the boot default. Retry the same command after an interruption: completed settings and passwords are preserved. Finish all service/network choices before this step. Add --options "console=ttyS0,115200n8" for a serial console.

For an explicitly selected mutable layout, use --boot mutable --root-device /dev/nvme0n1p2 instead of the A/B arguments.

17. Unmount and Reboot

Warning
Required, after the Boot step passed. On A/B that is verify-installation: PASSED. On a mutable installation, which has no recab, it is the boot entry you can list here.
Mutable installations: confirm the boot entry exists on the EFI partition
ls /mnt/boot/loader/entries
Unmount the installed system, deepest mount first
umount /mnt/boot
umount /mnt/var
umount /mnt
Reboot, then remove the installation media
reboot

After the reboot, AcornOS is installed. Continue to Post-Installation.