Phoebus OS installation help
============================

What the installer does
-----------------------
The installer creates a GPT disk layout with an EFI system partition, a LUKS2
encrypted container and a Btrfs filesystem with the @ / @home / @var
/@snapshots / @swap subvolumes. It then installs a verified Gentoo stage3 and
the packages needed for a Mango + DankMaterialShell desktop with PipeWire,
Flatpak and Nix.

Nothing is written to a disk until you have reviewed the plan and typed ERASE
on the confirmation screen.

Requirements
------------
- 64-bit UEFI machine.
- At least 4 GiB of RAM and enough disk space (32 GiB or more recommended).
- A network connection during installation (the stage3 and packages are
  downloaded; the installed system can boot and run offline).
- A connected AI model. Phoebus ships no model. Connect a hosted provider
  (DeepSeek or OpenAI) or point the installer at a model you serve locally.
  The installed system works without the model; you can always use the
  deterministic `sys` command instead.

Choosing a disk
---------------
Only whole, writable disks are offered. Disks that hold mounted filesystems,
the live installation medium, optical/loop device-mapper devices and read-only
devices are protected and cannot be selected.

Destructive changes
-------------------
Everything on the selected disk is destroyed. If the installation fails, the
screen tells you whether disk changes occurred and what the safe next actions
are. A failed installation can be restarted from the review screen; the disk is
re-created from scratch.

Getting help
------------
- The full installer log is at /var/log/phoebus-installer/install.log.
- The serial console (Ctrl+Alt+F2) logs in as phoebus / phoebus on the live
  medium; sudo is passwordless there.
- Open "Advanced tools" on the welcome screen for a terminal, system log,
  installer log and disk information.
