How to Attach a Custom ISO to a Vultr VX1™ Cloud Compute Instance
How to Attach a Custom ISO to a Vultr VX1™ Cloud Compute Instance
Attach and boot custom ISO images on your Vultr VX1™ Cloud Compute instance using the Customer Portal or API for flexible OS installation.
ISO images allow you to install a specific operating system on a Vultr VX1™ Cloud Compute instance. Custom ISOs enable you to deploy operating systems not available in the default Vultr installer list. They are useful for creating tailored environments or booting into specialized modes, such as rescue and recovery environments.
Follow this guide to attach a custom ISO to a Vultr VX1™ Cloud Compute instance using the Vultr Customer Portal, or API.
Installing a custom ISO on a Vultr VX1™ Cloud Compute instance disables the default user credentials listed in your instance’s management page.
Vultr Customer Portal
- Navigate to Products and click Compute.
- Click your target Vultr VX1™ Cloud Compute instance to open its management page.
- Navigate to the Settings tab.
- Find and click Custom ISO on the left navigation menu.
- Select a custom ISO available in your Vultr account or click the ISO Library drop-down to select from a list of public ISOs.
- Click Attach ISO and Reboot to attach the ISO to your instance.
Vultr API
- Send a
GETrequest to the List Instances endpoint and note your target instance’s ID.console$ curl "https://api.vultr.com/v2/instances" \ -X GET \ -H "Authorization: Bearer ${VULTR_API_KEY}"
- Send a
GETrequest to the List ISOs endpoint and note your target ISO ID.console$ curl "https://api.vultr.com/v2/iso" \ -X GET \ -H "Authorization: Bearer ${VULTR_API_KEY}"
- Send a
POSTrequest to the Attach ISO to Instance endpoint to attach the ISO to your target instance.console$ curl "https://api.vultr.com/v2/instances/{instance-id}/iso/attach" \ -X POST \ -H "Authorization: Bearer ${VULTR_API_KEY}" \ -H "Content-Type: application/json" \ --data '{ "iso_id" : "<iso-id>" }'
If successful, you receive a
200status code response.