systemd/particleos is tracked by TopGit as a security tool, with 627 stars on GitHub, written primarily in Shell. ⸭ An image-based, secure OS, built on top of various Linux distributions
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
ParticleOS is a fully customizable immutable distribution implementing the
concepts described in
Fitting Everything Together.
Note that ParticleOS is still in development, and we don't provide any backwards
compatibility guarantees at all.
The crucial difference that makes ParticleOS unique compared to other immutable
distributions is that users build the ParticleOS image themselves and sign it
with their own keys instead of installing vendor signed images. This allows
configuring the image to your liking by having full control over which
distribution is used as the base and which packages are installed into the
image.
The ParticleOS image is built using mkosi.
You will need to install the current main branch of mkosi to build current
ParticleOS images.
First, configure the variant you'd like to build in mkosi.local.conf. For a
desktop system, you'll want the desktop and one of gnome, kde, or
sway profiles.
It is also strongly recommended to write a hashed root password prefixed with
hashed: to mkosi.rootpw to allow debugging the system if something breaks.
To build the image, run mkosi -B -f from the ParticleOS repository. Currently
arch, fedora, debian and ubuntu are supported distributions.
Implementing support for a new distribution (that's already supported in mkosi)
is as simple as writing the necessary config files to install the required
packages for that distribution.
To update the system after installation, you clone the ParticleOS repository
or your fork of it, make sure mkosi.local.conf is configured to your liking and
run mkosi -B -ff sysupdate -- update --reboot which will update the system using
systemd-sysupdate and then reboot.
Using the OBS profile to fetch a newer systemd
Sometimes ParticleOS adopts systemd features as soon as they get merged into
systemd without waiting for an official release. That's why we recommend
enabling the obs-repos profile to enable the systemd repositories on OBS
(https://software.opensuse.org//download.html?project=system%3Asystemd&package=systemd)
containing systemd packages which are built every day from systemd's git main
branch.
To enable the obs-repos profile, add the following to mkosi.local.conf:
[Config]
Profiles=obs-repos
We also provide the obs-repos-stable profile, that will use the latest stable
branch of systemd, instead of main, providing more stability and less risk, as
it is what distributions typically use. To enable this profile, add the
following to mkosi.local.conf:
[Config]
Profiles=obs-repos-stable
Building systemd from source
As an alternative to using the obs-repos profile, you can build systemd from source:
Then write the following to mkosi.local.conf in the ParticleOS repository to
use the artifacts from the systemd repository built by mkosi in ParticleOS:
Make sure the distribution and release in mkosi.local.conf are identical in the
systemd checkout and the particleos checkout.
To build a newer systemd, run git pull in the systemd repository followed by
mkosi -f sandbox -- meson compile -C build and mkosi -t none.
Signing keys
ParticleOS images are signed for Secure Boot with the user's keys. To generate a new key,
run mkosi genkey. The key must be stored safely, it will be required to sign updates.
The key can be stored in a smartcard. Then you have to set the key in mkosi.local.conf:
ParticleOS images are built on the Open Build Service
and can be downloaded and installed. Currently x86-64 GNOME flavours of Fedora and
Debian are provided and can be found in the respective "images" directory at the
aforementioned link.
The sources can be found in the obs branch of this repository, and the build
configuration can be found in the system:systemd project
on OBS. These images will contain systemd built from latest git main, rather
than what the respective distributions provide.
Images built using the latest systemd stable branch, instead of main, are also
provided, in the system:systemd:stable project
project on OBS. The ParticleOS configuration is the same, the only difference is
the systemd packages, which should be safer and more stable to use.
The trust model of these images is as follows: any private key material used
to sign the images is handled automatically and securely by OBS, and is not
available to the project maintainers. The OBS signing certificate
for the system:systemd project and the MSFT 3rd party 2011 and 2023 CAs
are set up to be self-enrolled for UEFI secure boot if the system is booted
in setup mode. The OBS PGP public key is enrolled in the systemd-sysupdate
preinstalled keyring, and sysupdate.d configuration is preinstalled to
automatically pull updates from OBS. The UKI is signed (both the image itself
and the PCR policies contained within) with the OBS system:systemd project
certificate as well. The dm-verity partitions are signed with the same key
as well.
Installation
Before installing ParticleOS, make sure that Secure Boot is in setupmode on the target system. The Secure Boot mode can be configured in
the UEFI firmware interface of the target system. If there's an
existing Linux installation on the target system already, run
systemctl reboot --firmware-setup to reboot into the UEFI firmware
interface. At the same time, make sure the UEFI firmware interface is
password protected so an attacker cannot just disable Secure Boot
again.
To install ParticleOS with a USB drive, first build the image on an
existing Linux system as described above. Then, write it to the USB
drive with mkosi burn /dev/<usb>. Once written to the USB drive, plug
the USB drive into the system onto which you'd like to install
ParticleOS and boot into the USB drive via the firmware menu. Then,
boot into the "Installer" UKI profile, which runs
systemd-sysinstall. It will prompt for the target drive and any
other details required, then partition the disk, copy ParticleOS onto
it, set up the ESP via bootctl install and finally install a kernel
via bootctl link. Once it completes, reboot into the target drive
(i.e not the USB drive) and the default profile (i.e. not the
installer one) to complete the installation.
If you prefer to drive the install manually, boot into the "Live
System" UKI profile instead. When you end up in the root shell, run
systemd-sysinstall to install ParticleOS to the system's drive,
then reboot as above. If you invoke systemd-sysinstall without
arguments it will interactively query you for configuration
parameters, as necessary. You may alternatively configure the new
installation with command line parameters of the tool, see the
systemd-sysinstall(8) man page for details.
LUKS recovery key
systemd doesn't support adding a recovery key to a partition enrolled with a token
only (tpm/fido2). It is possible to use cryptenroll to add a recovery password
to the root partition: cryptsetup luksAddKey --token-type systemd-tpm2 /dev/<id>
Firmwares
Only firmwares that are dependencies of a kernel module are included, but some
modules don't declare their dependencies properly. Dependencies of a module can be
found with modinfo. If you experience missing firmwares, you should report
this to the module maintainer. FirmwareInclude= can be added in mkosi.local.conf
to include the firmware regardless of whether a module depends on it.
Configuring systemd-homed after installation
After installing ParticleOS and logging into your systemd-homed managed user,
run the following to configure systemd-homed for the best experience:
Disabling the auto resize mode avoids slow system boot and shutdown. Enabling
LUKS discard makes sure the home directory doesn't become inaccessible because
systemd-homed is unable to resize the home directory.
Default root password and user when booting in a virtual machine
If you boot ParticleOS in a virtual machine using mkosi vm, the root password
is automatically set to particleos and a default user particleos with password
particleos is created as well.
The most recent commit recorded on systemd/particleos was 12 days ago, based on the GitHub push timestamp. The repository has 70 forks — one of the better signals of community interest.
How does systemd/particleos compare to other Security projects?
systemd/particleos is tracked by TopGit in the Security category, with 627 GitHub stars and written in Shell. Browse the Security topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does systemd/particleos have?
systemd/particleos has 627 GitHub stars — refresh the page for the live number, or check github.com/systemd/particleos. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is systemd/particleos?
systemd/particleos (systemd/particleos) is a Shell project on GitHub. From the project's own README: ⸭ An image-based, secure OS, built on top of various Linux distributions
What language is systemd/particleos written in?
systemd/particleos is written primarily in Shell. GitHub's language field is based on the largest share of bytes in the default branch.
What topics is systemd/particleos associated with?
GitHub's repository topics for systemd/particleos: "distribution", "image-based", "linux", "os", "security". TopGit's editorial category is Security.
Why is systemd/particleos categorized under Security?
TopGit places systemd/particleos in the Security category based on its GitHub topics and description (tagged: "distribution", "image-based", "linux"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Want a second opinion on particleos?
Ask an AI that can read this page — one click and you get its take on particleos.