Docs: Base System

AcornOS documentation

Base System

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

6. Verify Installation Media

Note
Option 1, the helper app: base-system checks the target, copies the system with a progress bar, shows the fstab entries (and any lines already in the target's fstab they would replace) and writes them. It reads the target from the disk step, so after disk-plan it needs no arguments. When it says the system is on the disk, go to Configuration. Option 2, by hand: skip base-system and use the commands below. Either way the system is copied, not installed: it has no boot files yet.
Check, copy and write the fstab interactively
base-system
Warning
Skip this - only if doing it by hand. base-system already checked the media.

The live media is already mounted. Verify the system image it installs is there:

Check for the EROFS image
ls -la /run/live-rootfs.erofs

7. Extract Base System

Warning
Skip this - only if doing it by hand. base-system already extracted the system.

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

Extract the system to /mnt
recstrap /mnt

This extracts the minimal base system: OpenRC, the userland, kernel modules, doas, the recipe package manager and, on A/B installations, recab. The rest (networkmanager, the desktop, Firefox, audio, printing and so on) comes in the next part, installed through Recipe. It checks the target first and the extracted system afterwards, before it reports success.

Verify extraction succeeded
ls /mnt/bin /mnt/usr /mnt/etc

8. Generate fstab

Warning
Skip this - only if doing it by hand. base-system already wrote the fstab.

Use recfstab (like Arch's genfstab) to detect the mounted filesystems and write their fstab entries:

Generate fstab from current mounts
recfstab --write /mnt
Verify the generated fstab
cat /mnt/etc/fstab

You should see entries for / (ext4), /boot (vfat) and, with the default A/B layout, /var (ext4), each with its UUID. Persistent state, shared by both roots, lives on /var. Root B has no entry: it is not mounted.

9. Inspect the New System

Warning
Skip this - only if doing it by hand. This only reads the system. system-setup shows the same choices on its own pages.

Stay in the live shell. recsetup reads the mounted target and lists the configuration choices it ships: its init system, libc and privilege tool among them.

Inspect the installed system
recsetup inspect --root /mnt --json

The system is copied, not installed. Continue from the live shell to Configuration (steps 10-14).