This guide covers the installation of one of the operating systems we have prepared on a VPS ON virtual machine. If you want to attach your own ISO file and install from it, follow the guide VPS ON – Connecting your own ISO and installing the OS.
The guide applies to VPS ON. For VPS SSD, follow the guide VPS SSD – Installation of a prepared OS.
In this article you will learn:
- How to remove an existing OS
- How to install a new OS
- How to set the root password in the ON Sunstone interface
- Common problems
- Frequently asked questions
Removing an existing OS
Before installing a new OS, first remove the original one. If you are installing an OS on a new VPS ON virtual machine, continue to the chapter Connecting a new OS.
To remove an existing operating system, follow these steps:
- Log in to the administration Open Nebula Sunstone ⧉.
- Go to Instances (Instance) VMs (Virtual machines).
- Select the virtual machine whose OS you want to remove.
- Turn off the machine using the Poweroff hard button (Force power off).
- Under the control buttons, select Storage (Storage).
- For the selected OS, click the cross icon in the Actions column (Actions) .
- Confirm the action in the pop-up window.

Connecting a new OS
If you want to attach your own ISO file and install the OS from it, follow the guide VPS ON – Connecting your own ISO and installing the OS.
To add an operating system from our offer, follow these steps:
- Log in to the administration Open Nebula Sunstone.
- Go to Instances (Instance) VMs (Virtual machines).
- Select the virtual machine to which you want to attach the OS.
- Make sure there is no OS on the virtual machine and that the machine is in the POWEROFF state.
- Under the control buttons, select Storage (Storage).
- Click the Attach disk button (Attach disk).
- Select the OS you want to install from the list.
- Select Advanced options (Advanced options).>
- Set the value of Size on instantiate (Size on instantiate) to the current VPS ON size.
- Confirm the option by clicking Attach (Attach).

Setting the root password in ON Sunstone
If you need to create or change the password for the root user in the operating system attached according to this guide, follow these steps:
- Log in to the administration Open Nebula Sunstone.
- Go to Instances (Instance) VMs (Virtual machines).
- Select the virtual machine where you want to change the password.
- In the Info tab, browse the content until you find PASSWORD in the Attributes table (Attributes).
- Click the pencil icon .
- Enter the new password and confirm with the Enter key.
- Turn off the virtual machine using the Power Off button .
- Turn on the virtual machine using Resume .

Common problems
Common problems with installing a prepared OS on VPS ON include:
- The selected OS is not in the image offer
- Stuck virtual machine during restart or disk detaching/attaching
- Unavailable or non-functional root user password
OS is not in the offer
Problem: The operating system I need to run on my server is not in the image offer.
Cause: We only provide selected versions of the Linux operating system. We continuously expand the list.
Solution: Install the OS from your own source according to the guide VPS ON – Connecting your own ISO and installing the OS.
Stuck VM
Problem: When working with disks or during shutdown/startup, the VM got stuck and is showing an unusual state.
Cause: In some cases, startup or shutdown may take longer than usual (on the order of minutes). In other cases, it may be a system error that needs to be resolved on our side.
Solution: Wait a few minutes. If the problem persists for tens of minutes, or the VM enters an unusual state that cannot be resolved by restarting, contact support ⧉. Provide the service number or name and the action that immediately preceded the freeze (for example, attaching a new disk).
Non-functional root password
Problem: The root password that arrived in the service setup email does not work, or no password was delivered.
Solution: Follow the instructions in the chapter Setting the root password in ON Sunstone. If the PASSWORD parameter is not in the table, add it.
Frequently asked questions
Why is Windows not offered? How do I install it?
We do not offer Windows operating systems for servers. If you want to run a Windows system, obtain your own license and install the system according to the guide VPS ON – Installing Windows with VirtIO.