Docs: Installation

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.

Note
Helper app or by hand, never both. Each of the first three parts has a helper app (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.
Warning
The helper apps do not install the system. After 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.
Note
A/B by default: the disk gets two roots, A and B, and a /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 with recpart: EFI, root A, root B and the /var state partition
  • Extract - base-system, or by hand recstrap (like pacstrap) and recfstab
  • Configure - system-setup, or by hand recsetup: time zone, locale, keymap, hostname and users
  • Boot loader (required, no helper app) - recsetup installs 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:

Shell
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:

AcornOSLevitateOS
Administrator commandsdoassudo
Desktop editionLXQt on X11 (XLibre)KDE Plasma on Wayland
Kernel6.18.63 (long-term support)7.3.4 (latest stable)