Skip to content

PXE boot

PXE server logs

To view PXE server (includes DHCP, TFTP and HTTP server) logs:



You can view the logs of one or more containers selectively, for example:

./scripts/pxe-logs dnsmasq
./scripts/pxe-logs http

Nodes not booting from the network

  • Plug a monitor and a keyboard to one of the bare metal node if possible to make the debugging process easier
  • Check if the controller (PXE server) is on the same subnet with bare metal nodes (sometimes Wifi will not work or conflict with wired Ethernet, try to turn it off)
  • Check if bare metal nodes are configured to boot from the network
  • Check if Wake-on-LAN is enabled
  • Check if the operating system ISO file is mounted
  • Check the controller's firewall config to make sure that the following ports are open:
    • DHCP (67/68)
    • TFTP (69)
    • HTTP (80)
  • Check PXE server Docker logs
  • Check if the servers are booting to the correct OS (Fedora Server installer instead of the previously installed OS), if not try to select it manually or remove the previous OS boot entry
  • Examine the network boot process with Wireshark or Termshark