Skip to content

Commit d688f9f

Browse files
committed
Add installation instructions
1 parent cb9ad74 commit d688f9f

File tree

1 file changed

+21
-5
lines changed

1 file changed

+21
-5
lines changed

README.md

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,27 @@ To update the system after installation, you clone the ParticleOS repository
2222
or your fork of it and run `mkosi -ff sysupdate update --reboot` which will
2323
update 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

3147
After installing ParticleOS and logging into your systemd-homed managed user,
3248
run the following to configure systemd-homed for the best experience:

0 commit comments

Comments
 (0)