Custom images allow you to use iPXE scripts to boot into your operating system of choice. Using an iPXE script to deploy a custom image gives you more flexibility and control over deployments, as you can customize an operating system to your needs and requirements. You must set a valid public URL where your iPXE script is stored. Your script should follow iPXE standards.

​
What is an iPXE script

The iPXE script contains a set of instructions that specify how the network boot process should be performed. This can include loading an operating system image from a remote server, setting up network configurations, and executing custom scripts or commands. Learn more about iPXE

​
Variables

You can use these three variables when writing your script.
VariableDescription
{{ PUBLIC_IP }}Public IP of the server that will be provisioned.
{{ PUBLIC_GW }}Public Gateway used to configure the network.
{{ INTERFACE_ID }}The public interface ID is used to configure the public interface of your server.
{{ NETMASK }}The Subnet Mask
If you need other variables to be exposed, send your feedback

​
How to deploy a custom image

  1. For the Opearting System option on the server create page, paste your iPXE script under Custom images or select one of the examples from the right.
Custom image selection on the Latitude.sh dashboard
  1. Finish filling out the rest of the server create form as usual, including selecting the server type, location, and any other options you need.
  2. When ready, click the Deploy button at the bottom of the page. Latitude.sh will begin deploying your server using your iPXE script, and you should see status updates on the server’s progress in your account dashboard.
Custom images take between 10 and 30 minutes to deploy, depending on the size of the image you are deploying.

​
Caveats

  • When deploying with a custom image, the server will report as active and show the On status in the dashboard. That doesn’t mean your image has finished installing. You will need to access the server console via Remote access to follow the installation process and make prompt selections, if applicable.