Documentation

Base System

Installation steps 6-9: Verify media, extract the system, generate fstab, and enter chroot. See Installation for an overview.

Section

6. Verify Installation Media

The live media is already mounted. Verify the canonical EROFS payload path is accessible:

Check for EROFS image

ls -la /run/live-rootfs.erofs

Section

7. Extract Base System

Use recstrap to extract the EROFS image to your mounted root:

Extract system to /mnt

recstrap /mnt

This extracts the complete system: kernel, systemd, coreutils, networking, and the recipe package manager.

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).

Verify extraction succeeded

ls /mnt/bin /mnt/usr /mnt/etc

Section

8. Generate fstab

Use recfstab (like Arch's genfstab) to automatically detect mounted filesystems and generate fstab entries:

Generate fstab from current mounts

recfstab /mnt >> /mnt/etc/fstab

Verify the generated fstab

cat /mnt/etc/fstab

You should see entries for / (ext4) and /boot (vfat) with UUIDs.

With the default A/B layout, you should also see an entry for /var (ext4). Persistent state (including /var/home) lives there.

Section

9. Enter the New System

Use recchroot (like Arch's arch-chroot) to enter the new system. It automatically sets up bind mounts for /dev, /proc, /sys, /run, and EFI variables:

Enter the installed system

recchroot /mnt

You are now inside the new system. Continue to Configuration (steps 10-14).