Go to file
Dustin f25226ebb5
basementhud/pipeline/head This commit looks good Details
Stub out kernel-network-modules dracut module
This dumb module includes a ton of useless drivers.  There doesn't seem
to be a way to avoid including it, because it is expressed as a
dependency of the *network* module, and even explicitly omitting the
modules it would include seems to have no effect.
2022-04-06 13:47:32 -05:00
ci Install Playwright to control Firefox 2022-04-04 20:59:34 -05:00
overlay Stub out kernel-network-modules dracut module 2022-04-06 13:47:32 -05:00
.gitignore Initial commit 2022-04-04 20:59:32 -05:00
Makefile Initial commit 2022-04-04 20:59:32 -05:00
README.md Initial commit 2022-04-04 20:59:32 -05:00
cmdline.txt cmdline: enable serial console 2022-04-04 20:59:34 -05:00
config.txt config: disable HDMI overscan 2022-04-04 20:59:34 -05:00
mkinitramfs.sh initramfs: Only include necessary drivers 2022-04-06 13:42:04 -05:00
mkrootfs.sh Install wmctrl 2022-04-06 10:57:25 -05:00
prepare.sh Initial commit 2022-04-04 20:59:32 -05:00
publish.sh publish: Upload rootfs image atomically 2022-04-04 20:59:34 -05:00
squashfs-exclude.txt Initial commit 2022-04-04 20:59:32 -05:00

README.md

Basement Hud Network-Booted OS

Customized Fedora-based operating system distributed as an immutable root filesystem image.

Building

Must run on a Fedora host or privileged container.

Build the root filesystem image:

make rootfs

This will create an _build/rootfs directory containing the root filesystem hierarchy. The _build/rootfs/boot directory contains the necessary files to boot the system:

  • efi: This directory contains the Raspberry Pi firmware files
  • initramfs.img: Early userspace image
  • vmlinuz: Kernel image
  • basementhud.squashfs: Root filesystem image

The Raspberry Pi firmware, initramfs image, and kernel image files must be served by a TFTP, while the rootfs image is served by NBD.

Build the initramfs image:

make initramfs