AcornOS documentation
Troubleshooting
Common issues and solutions for AcornOS installation and usage.
Install Issues
recpart refuses the disk
It prints the check that failed, an error code and what to do. --dry-run runs the same checks without changing anything.
recpart apply --disk /dev/nvme0n1 --dry-run Boot Issues
System fails to boot
Boot from the ISO again and check the installed boot files:
mount /dev/nvme0n1p2 /mnt
mount /dev/nvme0n1p1 /mnt/boot
mount /dev/nvme0n1p4 /mnt/var ls /mnt/boot/loader/entries
ls /mnt/boot/acornos-a You should see acornos-a.conf and acornos-b.conf, and vmlinuz and initramfs.img for root A. Each entry's options line names its root by root=PARTUUID=; compare it with blkid -s PARTUUID /dev/nvme0n1p2.
recsetup apply --root /mnt --boot ab --slot-a /dev/nvme0n1p2 --slot-b /dev/nvme0n1p3 --machine-id && recab verify-installation --root /mnt Bootloader not found (UEFI)
Ensure you booted in UEFI mode and the ESP is mounted correctly:
ls /sys/firmware/efi/efivars findmnt /boot The other root did not start
The boot default is the root that last finished starting. When the other root does not finish starting, the next boot starts the previous root again. recab status shows which root is booted, which is the other and what boots next; recab health shows how startup ended. To start over from the running system, run recab copy: it overwrites the other root with a copy of the booted root.
recab status Network Issues
No network after reboot
ip addr rc-service networkmanager status doas rc-update add networkmanager default
doas rc-service networkmanager start WiFi adapter not detected
nmcli device wifi list If no wireless device appears, the card may need firmware the system does not ship.
Package Issues
Package installation fails
Recipe reports the failure and names the failing step. See what it holds and which step is done:
doas recipe state packagename Inspect recipe explain packagename: downloads need every server and redirect target in the recipe's NEEDS.network. Caller --network-host and --no-network can only restrict it. The full log of every run is under /var/lib/recipe/state/logs/.
doas recipe cleanup packagename
doas recipe install packagename