@@ -13,7 +13,7 @@ Your LXC container hosts only two things:
1313- ** iPXE bootloader binaries** (` .efi ` , ` .kpxe ` files — a few hundred KB each)
1414- ** iPXE menu files** (plain text ` .ipxe ` scripts that define the menu structure)
1515
16- That's it. The container serves ~ 4 MB of files total.
16+ That's it. The container serves ~ 80 MB of files total (bootloaders + menus) .
1717
1818When a machine PXE-boots, it:
1919
@@ -53,7 +53,7 @@ Creates a minimal Debian 13 LXC container:
5353| ----------- | ------ |
5454| CPU | 1 core |
5555| RAM | 512 MB |
56- | Disk | 4 GB |
56+ | Disk | 8 GB |
5757| Port (HTTP) | 80/TCP |
5858| Port (TFTP) | 69/UDP |
5959
@@ -133,17 +133,71 @@ http://<container-ip>/netboot.xyz.efi
133133
134134## Available Bootloader Files
135135
136- All files are served at ` http://<container-ip>/ ` :
137-
138- | File | Protocol | Architecture | Use case |
139- | --------------------------- | --------- | ------------ | -------------------------------------- |
140- | ` netboot.xyz.efi ` | HTTP/TFTP | x86_64 UEFI | Standard UEFI boot |
141- | ` netboot.xyz-snp.efi ` | HTTP/TFTP | x86_64 UEFI | UEFI SNP — tries all network devices |
142- | ` netboot.xyz-snponly.efi ` | HTTP/TFTP | x86_64 UEFI | UEFI SNP — only chained device |
143- | ` netboot.xyz.kpxe ` | TFTP | x86_64 BIOS | Legacy BIOS, built-in iPXE NIC drivers |
144- | ` netboot.xyz-undionly.kpxe ` | TFTP | x86_64 BIOS | Legacy BIOS fallback (NIC issues) |
136+ All files are served at ` http://<container-ip>/ ` and ` http://<container-ip>/ipxe/ ` :
137+
138+ ### x86_64 UEFI
139+
140+ | File | Use case |
141+ | ------------------------- | ----------------------------------------------- |
142+ | ` netboot.xyz.efi ` | Standard UEFI — recommended starting point |
143+ | ` netboot.xyz.efi.dsk ` | Virtual floppy/disk image of the EFI bootloader |
144+ | ` netboot.xyz-snp.efi ` | UEFI SNP — tries all network devices |
145+ | ` netboot.xyz-snp.efi.dsk ` | Disk image of SNP EFI bootloader |
146+ | ` netboot.xyz-snponly.efi ` | UEFI SNP — only boots from chained device |
147+
148+ ### x86_64 UEFI Metal (Secure Boot / code-signed)
149+
150+ | File | Use case |
151+ | ------------------------------- | ------------------------------------------- |
152+ | ` netboot.xyz-metal.efi ` | Secure Boot compatible UEFI bootloader |
153+ | ` netboot.xyz-metal.efi.dsk ` | Disk image of metal EFI bootloader |
154+ | ` netboot.xyz-metal-snp.efi ` | Secure Boot SNP — tries all network devices |
155+ | ` netboot.xyz-metal-snp.efi.dsk ` | Disk image of metal SNP EFI bootloader |
156+ | ` netboot.xyz-metal-snponly.efi ` | Secure Boot SNP — only chained device |
157+
158+ ### x86_64 BIOS / Legacy
159+
160+ | File | Use case |
161+ | --------------------------- | ------------------------------------------------- |
162+ | ` netboot.xyz.kpxe ` | BIOS PXE — built-in iPXE NIC drivers |
163+ | ` netboot.xyz-undionly.kpxe ` | BIOS PXE fallback — use if NIC has driver issues |
164+ | ` netboot.xyz-metal.kpxe ` | BIOS PXE — Secure Boot / code-signed variant |
165+ | ` netboot.xyz.lkrn ` | Kernel module — load from GRUB/EXTLINUX |
166+ | ` netboot.xyz-linux.bin ` | Linux binary — chainload from existing Linux boot |
167+ | ` netboot.xyz.dsk ` | Virtual floppy disk for DRAC/iLO, VMware, etc. |
168+ | ` netboot.xyz.pdsk ` | Padded virtual floppy disk |
169+
170+ ### ARM64
171+
172+ | File | Use case |
173+ | ------------------------------------- | ------------------------------------------- |
174+ | ` netboot.xyz-arm64.efi ` | ARM64 UEFI — standard |
175+ | ` netboot.xyz-arm64-snp.efi ` | ARM64 UEFI SNP — tries all network devices |
176+ | ` netboot.xyz-arm64-snponly.efi ` | ARM64 UEFI SNP — only chained device |
177+ | ` netboot.xyz-metal-arm64.efi ` | ARM64 Secure Boot UEFI |
178+ | ` netboot.xyz-metal-arm64-snp.efi ` | ARM64 Secure Boot SNP |
179+ | ` netboot.xyz-metal-arm64-snponly.efi ` | ARM64 Secure Boot SNP — only chained device |
180+
181+ ### ISO / IMG (for media creation or virtual boot)
182+
183+ | File | Use case |
184+ | --------------------------- | ------------------------------------------------- |
185+ | ` netboot.xyz.iso ` | x86_64 ISO — CD/DVD, virtual CD, DRAC/iLO, VMware |
186+ | ` netboot.xyz.img ` | x86_64 IMG — USB key creation |
187+ | ` netboot.xyz-arm64.iso ` | ARM64 ISO |
188+ | ` netboot.xyz-arm64.img ` | ARM64 IMG — USB key creation |
189+ | ` netboot.xyz-multiarch.iso ` | Combined x86_64 + ARM64 ISO |
190+ | ` netboot.xyz-multiarch.img ` | Combined x86_64 + ARM64 IMG |
191+
192+ ### Checksums
193+
194+ | File | Use case |
195+ | ---------------------------------- | --------------------------- |
196+ | ` netboot.xyz-sha256-checksums.txt ` | SHA256 hashes for all files |
145197
146198> ** BIOS vs UEFI:** Use ` .efi ` for UEFI systems, ` .kpxe ` for legacy BIOS. Mixing them causes silent failures.
199+ >
200+ > ** Secure Boot:** Use the ` -metal- ` variants if your firmware enforces Secure Boot.
147201
148202---
149203
0 commit comments