Boot the ESXi Installer by Using PXE and TFTP

You can use a TFTP server to PXE boot the ESXi installer. The process differs slightly depending on whether you use UEFI or boot from a legacy BIOS.

For legacy BIOS machines, the procedure supports booting multiple different versions of the ESXi installer by using the same pxelinux.0 initial boot loader for all target machines, but potentially different PXELINUX configuration files depending on the target machine's MAC address.
For UEFI machines, the procedure supports booting multiple different versions of the ESXi installer by using the same mboot.efi initial boot loader for all target machines, but potentially different boot.cfg files depending on the target machine's MAC address.

Prerequisites

Because most environments include ESXi hosts that support UEFI boot and hosts that support only legacy BIOS, this topic discusses prerequisites and steps for both types of hosts.

Verify that your environment meets the following prerequisites.

ESXi installer ISO image, downloaded from the VMware Web site.
Target host with a hardware configuration that is supported for your version of ESXi. See the VMware Compatibility Guide.
Network adapter with PXE support on the target ESXi host.
DHCP server that you can configure for PXE booting. See Sample DHCP Configurations.
TFTP server.
Network security policies to allow TFTP traffic (UDP port 69).
For legacy BIOS, you can use only IPv4 networking. For UEFI PXE boot, you can use IPv4 or IPv6 networking.
(Optional) Installation script (kickstart file).
Use a native VLAN in most cases. If you want to specify the VLAN ID to be used with PXE booting, check that your NIC supports VLAN ID specification.

For legacy BIOS systems, obtain version 3.86 of the SYSLINUX package. For more information, see Network Boot Background Information.

Procedure

If your ESXi host runs legacy BIOS firmware only, obtain and configure PXELINUX.

Obtain SYSLINUX version 3.86, unpack it, and copy the pxelinux.0 file to the top-level /tftpboot directory on your TFTP server.
Create a PXELINUX configuration file using the following code model.
ESXi-8.x.x-XXXXXX is the name of the TFTP subdirectory that contains the ESXi installer files.
```
DEFAULT install
NOHALT 1
LABEL install
  KERNEL ESXi-8.x.x-XXXXXX/mboot.c32
  APPEND -c ESXi-8.x.x-XXXXXX/boot.cfg
  IPAPPEND 2
```

Save the PXELINUX file in the /tftpboot/pxelinux.cfg directory on your TFTP server with a filename that will determine whether all hosts boot this installer by default:

Option	Description
Same installer	Name the file default if you want all host to boot this ESXi installer by default.
Different installers	Name the file with the MAC address of the target host machine (01-`mac_address_of_target_ESXi_host`) if you want only a specific host to boot with this file, for example, 01-23-45-67-89-0a-bc.

If your ESXi host runs UEFI firmware, copy the efi/boot/bootx64.efi and efi/boot/crypto64.efi files from the ESXi installer ISO image to the /tftpboot folder on your TFTP server.
Rename the efi/boot/bootx64.efi file to mboot.efi.

Note: Newer versions of mboot.efi can generally boot older versions of ESXi, but older versions of mboot.efi might be unable to boot newer versions of ESXi. If you plan to configure different hosts to boot different versions of the ESXi installer, use the mboot.efi from the newest version.
Configure the DHCP server.
Create a subdirectory of your TFTP server's top-level /tftpboot directory and name it after the version of ESXi it will hold, for example, /tftpboot/ESXi-8.x.x-xxxxx.
Copy the contents of the ESXi installer image to the newly created directory.
Modify the boot.cfg file
1. Add the following line:
```
prefix=ESXi-8.x.x-xxxxxx
```
  Here, ESXi-8.x.x-xxxxxx is the pathname of the installer files relative to the TFTP server's root directory.
2. If the filenames in the kernel= and modules= lines begin with a forward slash (/) character, delete that character.
3. If the kernelopt= line contains the string cdromBoot, remove the string only.
(Optional) For a scripted installation, in the boot.cfg file, add the kernelopt option to the line after the kernel command, to specify the location of the installation script.
Use the following code as a model, where XXX.XXX.XXX.XXX is the IP address of the server where the installation script resides, and esxi_ksFiles is the directory that contains the ks.cfg file.
```
kernelopt=ks=http://XXX.XXX.XXX.XXX/esxi_ksFiles/ks.cfg
```

If your ESXi host runs UEFI firmware, specify whether you want all UEFI hosts to boot the same installer.

Option	Description
Same installer	Copy or link the boot.cfg file to /tftpboot/boot.cfg
Different installers	Create a subdirectory of /tftpboot named after the MAC address of the target host machine (01-`mac_address_of_target_ESXi_host`), for example, 01-23-45-67-89-0a-bc. Place a copy of (or a link to) the host's boot.cfg file in that directory, for example, /tftpboot/01-23-45-67-89-0a-bc/boot.cfg.