Skip to main content

Quick Start

Getting started

Download one of the netboot.xyz bootloaders that works best for your situation and start PXE booting your favorite operating system. The bootloaders are precompiled versions of the latest version of iPXE that will allow you to PXE boot into https://boot.netboot.xyz. If you have DHCP it'll automatically attempt to boot from DHCP. If you need to set a static IP address, hit the 'm' key during boot up for the failsafe menu and choose manual network configuration.

You can look at the next section entitled Boot Methods for instructions on how to set up the downloaded bootloader.

If you already have iPXE up and running on the network, you can hit load the netboot.xyz kernel by typing the following when loaded in a legacy BIOS:

chain --autofree http://boot.netboot.xyz/ipxe/netboot.xyz.lkrn

or when in EFI mode:

chain --autofree http://boot.netboot.xyz/ipxe/netboot.xyz.efi

Note: If your version of iPXE has HTTPS support compiled in, you can retrieve those images over HTTPS. By default iPXE does not compile in HTTPS support.

This will load the appropriate netboot.xyz kernel with all of the proper options enabled.

Source Code

The source code for netboot.xyz is located here.

Contributing

New version of an operating system out? Found one that network boots well with iPXE? Pull requests are welcomed and encouraged and helps out a ton! Feel free to issue a pull request for new versions or tools that you might find useful. Once merged into master, Github Actions will regenerate new versions of iPXE from upstream and deploy the latest changes to netboot.xyz. See more on contributing here.

Testing New Features

Under the Utilities menu on netboot.xyz, there's an option for "netboot.xyz endpoints". Features or changes that have been merged into the development branch can be loaded here to be tested before they are merged into production.

Communication

Feel free to open up an issue on Github or join us on our Discord server. Follow us on Twitter or like us on Facebook!