Documentation
Installation
Step-by-step guide to installing LevitateOS from the live environment.
Section
Overview
Installing LevitateOS follows the same process as Arch Linux. You'll boot from a live environment, prepare your disk, extract the system with recstrap, and configure before rebooting. No network connection is required.
WARNING
Default update model: A/B immutable (slot updates + rollback). Mutable mode is an explicit opt-in for daredevils, and is unsafe if you let an LLM author recipes without review. See Atomic Updates (A/B).
Section
What You'll Do
- Boot - Boot the live ISO
- Partition - Create the default A/B layout: EFI + system-a + system-b + var
- Extract - Use recstrap to extract the system (like pacstrap)
- Configure - Set timezone, locale, hostname, users
- Bootloader - Install systemd-boot and A/B boot entries
- Reboot - Boot into your new LevitateOS installation
Section
Installation Steps
- Disk Preparation - Boot, identify disk, partition, format, mount (steps 1-5)
- Base System - Extract with recstrap, generate fstab, enter chroot (steps 6-9)
- Configuration - Timezone, locale, hostname, passwords, user account (steps 10-14)
- Bootloader & Finish - Install A/B boot images, install bootloader, enable services, reboot (steps 15-18)