Chapter 1 · 1.7
Reinstalling or attaching an ISO
Reinstalling: a clean slate
Has your server become a mess, or do you think it has been hacked (see Hacked? The first steps)? Then reinstall it.
- First save everything you want to keep: a restic backup (see Backups with restic to another location) or a copy on your own computer.
- Open the VPS screen and choose the Advanced tab.
- Under Reinstall, click Reinstall.... Choose the operating system, a new root password and, if you like, your SSH key.
- Click Erase everything and reinstall and confirm with your WebOké password.
Everything on your VPS is erased, including the snapshots. This cannot be undone. Your IP addresses stay the same, so you don't need to change your DNS.
Tip: After the reinstall, your server has a new fingerprint. That's why your computer shows a warning the first time you log in. That's normal here; Common SSH error messages explains how to fix it.
When you reinstall, you can also add your own cloud-init below the SSH key, so your server is set up again the way you want straight away. See Custom cloud-init: set up your VPS automatically on first boot.
Attaching an ISO
Want to do the installation yourself, for example with your own disk layout, or do you want to boot a repair environment? Then attach an ISO as a virtual CD. You do this in the Advanced tab, under Attach ISO. Choose an ISO under Available ISOs.
| Button | What happens? |
|---|---|
| Attach | The ISO is in the CD drive; your VPS still boots from the disk as usual. |
| Attach and boot from ISO | Your VPS shuts down and boots from the ISO. You confirm with Attach and restart. |
| Detach (under Currently attached) | The ISO is removed and your VPS boots from the disk again. Don't forget to do this afterwards. |
After that, you work in the console (see The console: your VPS in your browser). Your own installation doesn't get the network automatically: the network details you need to fill in are in Attaching your own ISO or reinstalling your VPS. Then also install qemu-guest-agent, otherwise the System tab and setting a password won't work.
Another operating system with WebOké netboot
Is the operating system you want not in the list, for example Fedora, Arch Linux, Alpine or openSUSE? Then attach weboke-netboot.iso with Attach and boot from ISO. This is a boot menu (based on netboot.xyz) that fetches the installation straight from the internet.
- Open the console. WebOké netboot asks for your IP address: type the IPv4 address of your VPS and press Enter.
- For the netmask, the gateway and the DNS, just press Enter each time. These are already set correctly.
- Choose Linux Network Installs (64-bit), then the distribution and the version.
- Follow the installer. Set up the network manually there, using the details from Attaching your own ISO or reinstalling your VPS.
- Detach the ISO before the final restart.
All the steps are in Installing another operating system on your VPS yourself (WebOké netboot). You can't install Windows this way.
Repairing from an ISO
Does your server no longer boot, or can't you get in even through the console? Then choose a Debian installation ISO with Attach and boot from ISO and select rescue mode in the menu. This lets you mount your disk and undo a setting. Take a snapshot first.
