@@ -22,11 +22,27 @@ To update the system after installation, you clone the ParticleOS repository
2222or your fork of it and run ` mkosi -ff sysupdate update --reboot ` which will
2323update the system using ` systemd-sysupdate ` and then reboot.
2424
25- There is no installer yet for ParticleOS. To install it, build the ParticleOS
26- image from another Linux system and ` dd ` it to the disk of the system you want
27- to run ParticleOS on.
28-
29- # Configuring systemd-homed after installation
25+ ## Installation
26+
27+ Before installing ParticleOS, make sure that Secure Boot is in setup mode on the
28+ target system. The Secure Boot mode can be configured in the UEFI firmware
29+ interface of the target system. If there's an existing Linux installation on the
30+ target system already, run ` systemctl reboot --firmware-setup ` to reboot into
31+ the UEFI firmware interface. At the same time, make sure the UEFI firmware
32+ interface is password protected so an attacker cannot just disable Secure Boot
33+ again.
34+
35+ To install ParticleOS with a USB drive, first build the image on an existing
36+ Linux system as described above. Then, burn it to the USB drive with
37+ ` mkosi burn /dev/<usb> ` . Once burned to the USB drive, plug the USB drive into
38+ the system onto which you'd like to install ParticleOS and boot into the USB
39+ drive via the firmware. Then, boot into the "Installer" UKI profile. When you
40+ end up in the root shell, run
41+ ` systemd-repart --dry-run=no --empty=force /dev/<drive> ` to install ParticleOS
42+ to the system's drive. Finally, reboot into the target drive (not the USB) and
43+ the regular profile (not the installer one) to complete the installation.
44+
45+ ## Configuring systemd-homed after installation
3046
3147After installing ParticleOS and logging into your systemd-homed managed user,
3248run the following to configure systemd-homed for the best experience:
0 commit comments