Documentation
Installation Tools Overview
Command-line tools for manual LevitateOS and AcornOS installation, equivalent to Arch Linux's partitioning tools, pacstrap, genfstab and arch-chroot.
Overview
LevitateOS and AcornOS ship the same five installation tools that mirror Arch Linux's manual installation workflow. They give you complete control over the installation process, and they are also the backends of the install screen's step apps, so the same commands work with or without a TUI.
| Tool | Arch Linux | Purpose |
|---|---|---|
| recpart | fdisk + mkfs + mount | Partition, format and mount the target disk |
| recstrap | pacstrap | Extract the base system to the target directory |
| recfstab | genfstab | Generate fstab from mounted filesystems |
| recsetup | the configuration steps | Time zone, locale, keymap, hostname, users, bootloader and services |
| recchroot | arch-chroot | Enter chroot with proper bind mounts |
Scope note: the repo also ships rec* tooling for the A/B roots and for building and testing images: recab, recinit, reciso, recqemu. See the rec* Tooling Overview.
Installation Workflow
The tools are used in sequence. The Installation Guide walks through each step.
Complete installation workflow:
-
recpart apply --disk /dev/nvme0n1 --confirm DESTROYCreate the A/B layout and mount it at /mnt (--mode mutable for one root)
-
recstrap /mntExtract the base system
-
recfstab --write /mntGenerate fstab entries
-
recsetup inspect --root /mnt --jsonList the time zones, locales, keymaps and services the target offers
-
recsetup apply --root /mnt --timezone Europe/Brussels --locale en_US.UTF-8Apply the machine settings
-
recchroot /mnt -- passwdSet the installed root password
-
recsetup apply --root /mnt --boot ab --slot-a /dev/nvme0n1p2 --slot-b /dev/nvme0n1p3 --machine-id && recab verify-installation --root /mntInstall systemd-boot and the A/B boot entries
-
umount /mnt/bootUnmount the installed system, deepest mount first
-
umount /mnt/varUnmount the installed system, deepest mount first
-
umount /mntUnmount the installed system, deepest mount first
-
rebootReboot into the installed system
Design Philosophy
Each tool does one thing and does it well:
- recpart only prepares the disk. It plans, shows every command, refuses unsafe layouts, and applies the plan only with
--confirm DESTROY. - recstrap only extracts files. It does not partition, format, mount, configure, or install bootloaders.
- recfstab only generates fstab. It outputs to stdout; you redirect to a file.
- recsetup only configures and boots the extracted system. It plans first and prints the exact commands it runs.
- recchroot only enters chroot. It sets up mounts, runs your command, and cleans up.
This separation means you understand exactly what each step does. If something goes wrong, you know which tool to debug.
Error Codes
recstrap, recfstab, recchroot and recsetup share one error table: each failure prints a code such as E004, which is also the exit status. The table is the Code enum in tools/recstrap/src/error.rs. recpart has its own (tools/recpart/src/error.rs).
See Also
- recpart Reference - Prepare the disk
- recstrap Reference - Extract the base system
- recfstab Reference - Generate fstab entries
- recsetup Reference - Configure and boot the system
- recchroot Reference - Enter chroot environment
- Installation Guide - Complete installation walkthrough