This guide applies to VPS ON. For VPS SSD, use the guide VPS SSD – Connecting and Booting from ISO.
This guide covers installing an OS from your own ISO file. If you want to install an OS from an image we have prepared, follow the guide VPS ON – Installing a Prepared OS. If you are installing Windows, follow the guide VPS ON – Installing Windows with VirtIO.
In this article, you will learn:
- How to create a CD/DVD ISO image
- How to attach an ISO image
- How to boot an operating system from ISO
- Common Issues
- Frequently Asked Questions
Creating a CD/DVD ISO Image
In the OpenNebula storage, you can have up to 3 custom ISO images of any CD/DVD at a time. These custom images are kept for 3 days from creation.
The maximum size of a custom ISO image is 8 GB. Larger images may not work correctly.
Create a CD/DVD image as follows:
- Log in to the administration Open Nebula Sunstone ⧉.
- Go to Storage (Storage) Images (Images).
- Click the green button + and select Create (Create).
- Fill in the fields Name (Name) and the path to the image, or upload your own file.
- For Type (Type) select Readonly CD-ROM (Readonly CD-ROM).
- Click the green button Create (Create) at the top of the page.

You can verify that the disk is ready for use in the image overview. The disk is usable from the moment its Status (Status) is READY (READY). To refresh the status overview, click the grey refresh button at the top of the page.

Attaching the ISO Image to the Server
If you have created a custom ISO image, attach it to the server as follows:
- Go to Instance (Instances) VMs (VMs).
- Select the server to which you want to attach the ISO image.
- If the server is on, turn it off and refresh until it is in the POWEROFF.
- Go to Storage (Storage) and select Attach disk (Attach disk).
- From the list, select the disk you want to attach; if it is in the READY (READY), confirm your choice by clicking the green button Attach (Attach).
- Turn on the server with the button at the top of the page.

When you have finished working with the disk, we recommend detaching it again. To detach it, click the cross × in the column Actions (Actions).
Booting the Operating System from ISO
This procedure will erase all data stored on the original disks. Make a backup before continuing with the guide.
First, check that no disks other than the installation CD-ROM are attached to the server. If you see another disk in the list, remove it by clicking the button in the column Actions (Actions) and refresh the VM status using the button .
If only the installation CD-ROM is attached to the system, attach an empty disk using this procedure (on VPS ON, skip steps 4 and 5; the system sets the size for you):
- Click the green button Attach disk (Attach disk).
- From the list of disks, select Empty Image.
- CLOUD: Select Advanced options (Advanced options).
- CLOUD: Set the value Size on instantiate (Size on instantiate) to the current size of the VPS.
- Confirm your choice by clicking the green button Attach (Attach).
- Refresh the status list by clicking the refresh button at the top of the page.

Complete the rest of the installation process with these steps:
- Turn on the server with the button at the top of the page.
- Open the KVM console with the button at the top of the page.
- Click the button SendCtrlAltDel, then quickly click the console window and press the Esc key to bring up the boot menu.
If the console displays the message No bootable device, repeat this step. - Select the number of the drive you want to boot from (the CD with a description).
- Continue with the installation itself.

Common Issues
Common problems with connecting a custom ISO and installing an OS on VPS ON include:
- The disk cannot be detached or attached
- Error: Limit reached for SYSTEM_DISK_SIZE quota in VM
- KVM does not respond to key presses
Cannot attach or detach a disk
Problem: The interface for attaching or detaching a disk does not work.
Cause: You cannot attach or detach disks while the VM is running, and you cannot detach disks while the VM is in the ATTACHING/DETACHING state.
Solution: Make sure the VM is in the POWEROFF state. Refresh the state by pressing the button .
Limit reached for SYSTEM_DISK_SIZE
Problem: When I try to attach an installation disk, I get the error limit reached for SYSTEM_DISK_SIZE quota in VM.
Cause: You are hitting a size limit, or the type of the disk being attached is wrong.
Solution: Make sure the ISO file is smaller than 8 GB and that its type is CDROM.
KVM does not respond to key presses
Problem: KVM does not respond to key presses.
Cause: Usually you have left the KVM interface by clicking outside the console area or by pressing a key (typically Esc), or there is a problem with the keyboard settings.
Solution: Click the console window and try the keys again. If KVM does not respond to number keys on the numeric keypad, try entering the numbers using the keys with the characters + to é.
Frequently Asked Questions
How do I install Windows?
Follow the guide VPS ON – Installing Windows with VirtIO.