systemd system extensions for Fedora image based systems

NOTE: This is currently an experimental project. Make sure to read the known limitations section. Use at your own risk.

For usage instructions, see the documentation at: extensions.fcos.fr

Building

Building those images currently require root privileges. The currently supported options for building those sysexts are:

• using a rootless, privileged, non-SELinux confined container (such as a toolbox/distrobox container), redirecting podman commands to run them on the host:

  [toolbox]$ cat /usr/local/bin/podman
  #!/bin/bash
  executable="$(basename ${0})"
  exec flatpak-spawn --host "${executable}" "${@}"
  

• Using nested podman containers (current path in CI).

Make sure that you have the following packages installed:

• cpio
• erofs-utils
• just
• podman
• wget

To build the python sysext:

$ cd python

List the supported target images:

$ just targets

Build the sysext for Fedora CoreOS next:

$ just build "quay.io/fedora/fedora-coreos:next"

extensions.fcos.fr redirector

A Caddy based redirector is hosted at extensions.fcos.fr. The configutation is available in Caddyfile. It redirects URLs queried by systemd-sysupdate to GitHub releases where the sysexts are hosted in this repo.

Contributing

See CONTRIBUTING for details about the CI setup specific to this repo.

Credits

This project is heavily inspired by the work done by Thilo on the Flatcar sysext bakery.

License

MIT.