Skip to content

README.md

Latest commit

 

History

History
44 lines (29 loc) · 1.49 KB

README.md

File metadata and controls

44 lines (29 loc) · 1.49 KB

Build the netboot images

This directory contains all the tooling necessary to build the netboot images:

  • kernel
  • initramdisk
  • live system .ISO file

The netboot images will be available in the bin/noble directory. To build the images:

  1. Change the SSH_KEYS variable in the Makefile to point to your public key file. This file will be downloaded and baked into the image
  2. install Docker and make and run:
$ make

Tip

The build requires privileged Docker containers, otherwise the build tools fail.

We're currently building the images based on Ubuntu 24.04 (Noble). The images will be placed in the bin/noble/ directory. You can copy them to a webserver of your choice.

Important

If you want to load the images from iPXE, the webserver must make them available over HTTP (it must not redirect to HTTPS). For kexec-based boot, the images can be available only over HTTPS.

Post-deploy script

You can create a post-deploy.sh file, set it as executable, and it will be executed at the end of the build process automatically. The script can, for example, synchronise the data to the TFTP or HTTP server.

Exploring the initramfs

If you want to explore the initramfs built by the live system builder, on a Debian/Ubuntu system you can use unmkinitramfs:

$ mkdir -p /tmp/initramdisk
$ unmkinitramfs bin/noble/initrd.img /tmp/initramdisk

Your files will be stored in /tmp/initramdisk. The unmkinitramfs binary comes from the initramfs-tools-core package.