Skip to content

Commit eb0a973

Browse files
committed
docs(netboot-xyz): fix guide — all 31 assets, 8GB disk, proper headings
1 parent 0deb262 commit eb0a973

1 file changed

Lines changed: 65 additions & 11 deletions

File tree

‎docs/guides/netboot-xyz.md‎

Lines changed: 65 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -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

1818
When 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

Comments
 (0)