governance.INSTALL_DOCUMENTSconstno test imports itconst INSTALL_DOCUMENTS: readonly ["user-data", "preseed.cfg", "ks.cfg", "autoinst.xml"]The files an install may ask the server for as its install document.
A boot profile: what one distribution needs from a network boot, as data. The server, the menus and the arming are the same for every distribution; a profile says which files are served and how each is pinned (BootPins), what the kernel is told on its command line, and which file under the install's URL is the install document the installer reads (the autoinstall's user-data, a Debian preseed.cfg, and so on). A boot server serves one profile at a time, because the names of the boot files (linux, initrd) are the same in every distribution.
The command line is a template: {base} is the boot server's URL (ending in a slash), {install} is the install's own URL (ending in a slash, with the host, the token and the MAC in it), {iso} is the URL of the installer image, and {mac} is what GRUB fills in as the MAC it booted from.
import { profileById } from "./profile.ts";
profileById("debian-13")?.document; // "preseed.cfg"governance.INSTALL_DOCUMENTSconstno test imports itconst INSTALL_DOCUMENTS: readonly ["user-data", "preseed.cfg", "ks.cfg", "autoinst.xml"]The files an install may ask the server for as its install document.
governance.InstallDocumenttypeno test imports ittype InstallDocument = (typeof INSTALL_DOCUMENTS)[number];The name of an install document.
governance.BootProfiletypeno test imports ittype BootProfile = {
/** The profile's name, as a person selects it: the distribution and its release. */
readonly i… (1180 characters)type BootProfile = {
/** The profile's name, as a person selects it: the distribution and its release. */
readonly id: string;
/** The family the platform model gives the distribution, so that the install is rendered for the right installer. */
readonly family: "debian" | "redhat" | "suse" | "arch";
/** The distribution and release as the menu says them. */
readonly title: string;
readonly pins: BootPins;
/** The name of the kernel among the pinned files. */
readonly kernel: string;
/** The name of the initial ramdisk among the pinned files. */
readonly initrd: string;
/** The kernel's command line, with the placeholders of the header. */
readonly cmdline: string;
/** The install document the installer reads from the install's URL. */
readonly document: InstallDocument;
/** The content type the install document is served with. */
readonly documentType: string;
/** Whether the installer can run the blank-disk guard before it touches a disk. Where it cannot, the install erases the disk it picks and an asset may be armed for it only with the owner's say-so that it may erase one (`confirmDestroy`). */
readonly guard: boolean;
};What one distribution needs from a network boot.
governance.UBUNTU_26_04_PROFILEconstno test imports itconst UBUNTU_26_04_PROFILE: BootProfileUbuntu 26.04.1: the live server's autoinstall, fed by cloud-init's NoCloud from the install's URL.
governance.DEBIAN_13constno test imports itconst DEBIAN_13: BootPinsDebian 13 (trixie): the netboot installer, which fetches its packages from the mirror, so there is no image. The files are those of the installer's current folder, pinned by the SHA-256 of its SHA256SUMS of 2026-11-21 (the files of a point release are replaced in place, so a new point release is adopted by changing these pins in a reviewed commit; a file that does not match its pin is not served).
governance.DEBIAN_13_PROFILEconstno test imports itconst DEBIAN_13_PROFILE: BootProfileDebian 13: the installer is told where its preseed is, and runs with no question that the preseed answers.
governance.ROCKY_9constno test imports itconst ROCKY_9: BootPinsRocky Linux 9.9: the installer's kernel and ramdisk and the network boot loader, pinned by the SHA-256 of the installer's .treeinfo of 2026-11-21 (and checked against the files themselves). The files of the tree are replaced in place by a point release, so a new one is adopted by changing these pins in a reviewed commit. The installer fetches its packages from the repository named on its command line.
governance.ROCKY_9_PROFILEconstno test imports itconst ROCKY_9_PROFILE: BootProfileRocky Linux 9: Anaconda is told where its Kickstart is and where the packages are.
governance.PROFILESconstno test imports itconst PROFILES: readonly BootProfile[]Every profile there is.
governance.profileByIdfunctionno test imports itfunction profileById(id: string): BootProfile | undefinedThe profile of a name, if there is one.
INSTALL_DOCUMENTSconstno test imports itconst INSTALL_DOCUMENTS: readonly ["user-data", "preseed.cfg", "ks.cfg", "autoinst.xml"]The files an install may ask the server for as its install document.
InstallDocumenttypeno test imports ittype InstallDocument = (typeof INSTALL_DOCUMENTS)[number];The name of an install document.
BootProfiletypetype BootProfile = {
/** The profile's name, as a person selects it: the distribution and its release. */
readonly i… (1180 characters)type BootProfile = {
/** The profile's name, as a person selects it: the distribution and its release. */
readonly id: string;
/** The family the platform model gives the distribution, so that the install is rendered for the right installer. */
readonly family: "debian" | "redhat" | "suse" | "arch";
/** The distribution and release as the menu says them. */
readonly title: string;
readonly pins: BootPins;
/** The name of the kernel among the pinned files. */
readonly kernel: string;
/** The name of the initial ramdisk among the pinned files. */
readonly initrd: string;
/** The kernel's command line, with the placeholders of the header. */
readonly cmdline: string;
/** The install document the installer reads from the install's URL. */
readonly document: InstallDocument;
/** The content type the install document is served with. */
readonly documentType: string;
/** Whether the installer can run the blank-disk guard before it touches a disk. Where it cannot, the install erases the disk it picks and an asset may be armed for it only with the owner's say-so that it may erase one (`confirmDestroy`). */
readonly guard: boolean;
};What one distribution needs from a network boot.
UBUNTU_26_04_PROFILEconstconst UBUNTU_26_04_PROFILE: BootProfileUbuntu 26.04.1: the live server's autoinstall, fed by cloud-init's NoCloud from the install's URL.
DEBIAN_13constno test imports itconst DEBIAN_13: BootPinsDebian 13 (trixie): the netboot installer, which fetches its packages from the mirror, so there is no image. The files are those of the installer's current folder, pinned by the SHA-256 of its SHA256SUMS of 2026-11-21 (the files of a point release are replaced in place, so a new point release is adopted by changing these pins in a reviewed commit; a file that does not match its pin is not served).
DEBIAN_13_PROFILEconstconst DEBIAN_13_PROFILE: BootProfileDebian 13: the installer is told where its preseed is, and runs with no question that the preseed answers.
ROCKY_9constno test imports itconst ROCKY_9: BootPinsRocky Linux 9.9: the installer's kernel and ramdisk and the network boot loader, pinned by the SHA-256 of the installer's .treeinfo of 2026-11-21 (and checked against the files themselves). The files of the tree are replaced in place by a point release, so a new one is adopted by changing these pins in a reviewed commit. The installer fetches its packages from the repository named on its command line.
ROCKY_9_PROFILEconstconst ROCKY_9_PROFILE: BootProfileRocky Linux 9: Anaconda is told where its Kickstart is and where the packages are.
PROFILESconstconst PROFILES: readonly BootProfile[]Every profile there is.
profileByIdfunctionfunction profileById(id: string): BootProfile | undefinedThe profile of a name, if there is one.