A feature that allows you to upload and attach your own ISO image to Vultr instances for custom operating system installations.
ISO images allow you to install a specific operating system on an Vultr Optimized 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 Optimized Cloud Compute instance using the Vultr Customer Portal, API, CLI, or Terraform.
Send a GET
request to the List Instances endpoint and note your target instance's ID.
$ curl "https://api.vultr.com/v2/instances" \
-X GET \
-H "Authorization: Bearer ${VULTR_API_KEY}"
Send a GET
request to the List ISOs endpoint and note your target ISO ID.
$ curl "https://api.vultr.com/v2/iso" \
-X GET \
-H "Authorization: Bearer ${VULTR_API_KEY}"
Send a POST
request to the Attach ISO to Instance endpoint to attach the ISO to your target instance.
$ 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>"
}'
List all available instances and note your target instance's ID.
$ vultr-cli instance list
List all available ISO images and note your target ISO's ID.
$ vultr-cli iso list
Attach the ISO to your target instance.
$ vultr-cli instance iso attach <instance-id> \
--iso-id="<iso-id>"
Open your Terraform configuration for the existing Optimized Cloud Compute instance.
Specify the ISO by its os_id
when defining or rebuilding the instance.
# Example: attach a custom ISO by its ID (replace 159 with your ISO ID)
resource "vultr_instance" "occ" {
label = "occ-custom-iso"
region = "del"
plan = "vhp-2c-4gb"
os_id = 159 # 'Custom' ISO type
iso_id = "your-iso-id-here" # ID of uploaded or library ISO
hostname = "occ-custom-iso"
}
Apply the configuration and observe the following output:
Apply complete! Resources: 0 added, 1 changed, 0 destroyed.
No comments yet.