Rebuilding the OS
How to rebuild your server's system disk with a clean operating system.
Rebuild erases the server's system disk and rebuilds it from a fresh template. It cannot be undone.
What changes and what doesn't
- Erased: every file, installed program and database on the system disk. Take a backup first.
- Unchanged: IP, MAC, hostname and subscription.
- Operating system: stays the one chosen when you ordered. You cannot pick another OS during a rebuild.
- Username and SSH key: taken from your order. Keys you added on the server later are removed.
- Extra data disks are not erased. On Linux they are not mounted automatically; you have to mount them again.
Steps
- Open your server under Services.
- At the bottom of the page, in the Danger zone panel, click Rebuild.
- In the dialog, check:
- whether you have a backup and when the last copy was taken;
- which disks are not erased;
- how many rebuilds you have used today.
- Save the password in New password. The portal does not keep it, but it is also e-mailed to you.
- Type the server's hostname exactly in the confirmation field.
- Click Rebuild.
The rebuild takes a few minutes. While it runs, the panel shows "Rebuilding the VM…" and the power buttons are disabled.
When it's done
The panel shows "Server rebuilt". Sign in with the new password and the same username. After the server boots, the Check on server row in the panel shows whether the hostname and password were really applied on the server; if it says "Not applied on the server", change the password manually from the console.
If you have extra data disks:
- Windows: in Disk Management, set the disk Online.
- Linux: find the disk with
lsblkandmountit. To mount it automatically at boot, add it to/etc/fstabusingblkid.
Limits
- Up to 2 rebuilds per day.
- Only one rebuild can run at a time.
- If it fails, the panel shows "Rebuild failed. Please contact support" with an RB-… reference. Include this reference in your ticket. In most cases the disk is left untouched and the server is returned to its previous state: if it was running, it is started again.