Download and select an executable image


  kernel [--name <name>] [--timeout <timeout>] <uri|image> [<arguments>...]


  imgselect [--name <name>] [--timeout <timeout>] <uri|image> [<arguments>...]


  imgload [--name <name>] [--timeout <timeout>] <uri|image> [<arguments>...]


Download and select the iPXE demonstration image


Download and boot a Linux kernel with an initrd


Download and boot a Multiboot kernel and modules



Download and select an executable image from the specified URI. A name for the downloaded image can be specified using the --name option. A download progress timeout can be specified (in milliseconds) using the --timeout option. Any remaining arguments will be passed directly to the image.

The image will become the selected image to be used as the default image for the boot command.

If this command is executed from within an iPXE script, then the URI will be interpreted as being relative to the URI of the script itself. For example, if the script contains the line

  kernel pxelinux.0

then iPXE will download and select

Command status

Success The image was successfully downloaded and selected
Failure The image was not successfully downloaded and selected

See also


There is no difference between the commands kernel, imgselect, and imgload.

After downloading and selecting an image using the kernel command, you can use the imgstat command to check that the image has been autodetected as the correct image type.

Backwards compatibility

In very old versions of iPXE, you must use kernel when you want to download and select a new image from a URI, and you must use imgselect or imgload when you want to select an image that has already been downloaded.

cmd/kernel.txt ยท Last modified: 2023/05/24 12:59 by mcb30
Recent changes RSS feed CC Attribution-Share Alike 4.0 International Driven by DokuWiki
All uses of this content must include an attribution to the iPXE project and the URL
References to "iPXE" may not be altered or removed.