AcornOS documentation
Installation
Step-by-step guide to installing AcornOS from the live environment.
Overview
Installing AcornOS follows the same process as Arch Linux. You boot the live ISO, partition the disk with recpart, extract the system with recstrap, configure it with recsetup, write the boot files, and reboot. No network connection is required.
disk-plan, base-system, system-setup) and the plain commands it runs. Use the helper or the commands. Where a helper did the work, the manual sections that follow it say Skip this - only if doing it by hand.disk-plan, base-system and system-setup, the machine still has no boot files. The Boot and Finish steps (Boot & Finish) are required: the installation is complete only when the boot files and entries are on the EFI partition and the verification has passed./var state partition. The booted root is locked; changes are made in the other root. Mutable mode, one root changed in place, is an explicit opt-in. See A/B Roots.What You'll Do
- Boot - Boot the live ISO into the install screen: a root terminal on the left, this guide on the right (Ctrl-] switches panes)
- Partition - Create the default A/B layout with
disk-plan, or by hand withrecpart: EFI, root A, root B and the/varstate partition - Extract -
base-system, or by handrecstrap(like pacstrap) andrecfstab - Configure -
system-setup, or by handrecsetup: time zone, locale, keymap, hostname and users - Boot loader (required, no helper app) -
recsetupinstalls systemd-boot and the boot entries on the EFI partition, then verification checks them - Finish (required) - Unmount, reboot, and remove the install media. Only now is AcornOS installed
Installation Steps
- Disk Preparation - Boot, identify the disk, partition, format and mount it (steps 1-5)
- Base System - Extract with recstrap, generate fstab, inspect the target (steps 6-9)
- Configuration - Install the default software through Recipe (some minutes), then timezone, locale, keymap, hostname, passwords, user account (steps 10-14)
- Boot & Finish - Required after the helper apps: write the boot files and entries, verify, unmount, reboot (steps 15-17)
After Installation: The Desktop
acornos-x86_64.iso installs the same base system as every ISO, then its default software set: 33 group recipes, LXQt and its apps among them, which recsetup's software step installs through Recipe, offline from the medium, each with a Recipe receipt, so you can remove or replace any of them later like any other software. It needs 4 GB (8 GB with the desktop). Build it from a checkout like the other ISOs (see Getting Started for <distro>); the first command downloads the packages the group recipes pin:
cargo xtask build rootfs-source <distro> --desktop
cargo xtask build release <distro> It boots like the other ISOs: into the install screen on the first virtual console and the serial console, with no desktop, so every step of this guide is the same. recstrap extracts the base system; recsetup installs the default set into it first (its software step, before the accounts and the boot step), and after the reboot the display manager asks for the account you made with recsetup.
The Sibling Distros
LevitateOS and AcornOS install the same way, with the same tools. They are meant to differ only in these:
| AcornOS | LevitateOS | |
|---|---|---|
| Administrator commands | doas | sudo |
| Desktop edition | LXQt on X11 (XLibre) | KDE Plasma on Wayland |
| Kernel | 6.18.63 (long-term support) | 7.3.4 (latest stable) |