Skip to content

iPXE Custom Build

PxeLab embedded boot scripts and multi-architecture build artifacts.

Related: Architecture Mapping | Boot Config


Embedded Boot Script

PxeLab uses custom-compiled iPXE binaries. All binaries embed the same boot script:

ipxe
#!ipxe
dhcp || goto dhcp_failed
isset proxydhcp/next-server && goto use_proxy

:use_dhcp
set next-server ${dhcp-server}
goto chain

:use_proxy
set next-server ${proxydhcp/next-server}

:chain
chain http://${next-server}:8080/boot/ipxe/script?mac=${net0/mac} || goto tftp_fallback
exit

:tftp_fallback
chain tftp://${next-server}/boot/menu.ipxe || shell
exit

:dhcp_failed
shell

Build All Architectures

bash
# Cross-compile with Docker (recommended)
make ipxe-build-all

# Manual build x86_64 EFI
make ipxe-build           # Non-embedded
make ipxe-build-embed     # Embedded (failsafe)

Build Artifacts

FileArchitecturePurpose
ipxe.pxex86 BIOSiPXE boot
ipxe32.efiEFI IA32iPXE boot
ipxe.efiEFI x86-64iPXE boot
snponly.efiEFI BCiPXE boot (SNP driver)
ipxe-arm32.efiEFI ARM32iPXE boot
ipxe-arm64.efiEFI ARM64iPXE boot
ipxe-riscv32.efiRISC-V 32iPXE boot
ipxe-riscv64.efiRISC-V 64iPXE boot
ipxe-loong64.efiLoongArch64iPXE boot
ipxe-x86_64-sb.efiEFI x86-64Secure Boot iPXE
ipxe-arm64-sb.efiEFI ARM64Secure Boot iPXE
shim-x86_64.efiEFI x86-64Secure Boot Shim
shim-arm64.efiEFI ARM64Secure Boot Shim

This document covers the complete iPXE build process. For more architecture details, see Architecture Mapping & Secure Boot.

PxeLab - All-in-one PXE Network Boot Server