OS templates are the images VirtFusion uses to build or rebuild a server in about a minute. ISOs let customers or staff install an OS by hand through the console. This guide covers both from the admin side.
Before you start
- A working control server and hypervisor with storage (Configure VirtFusion storage).
- Admin access to VirtFusion.
How templates work
VirtFusion templates are cloud images. When a server is built, the image is written to its disk and cloud-init sets the hostname, root password or SSH key and network settings that VirtFusion passes in. That is why IP blocks must be correct first (VirtFusion networking).
Enable OS templates
- In the admin area, open the OS templates section.
- Enable the distributions you want to offer, for example current Ubuntu LTS, Debian, AlmaLinux and Rocky Linux releases.
- Organise them into groups so customers see a short, clear list.
- Make the template groups available to the packages that should offer them.
Tip: Offer fewer, current releases. End-of-life images create support work and security risk. See Ubuntu vs Debian for a VPS when choosing defaults.
Add an ISO
- Open the ISO/media section of the admin area and add an ISO by URL or upload, as your version allows.
- Make it available to the right hypervisors or users.
- To use it, attach the ISO to a server, set the boot order to CD-ROM first and open the VNC console to run the installer.
- After installing, detach the ISO and set the boot order back to disk.
Servers installed from an ISO do not get cloud-init networking; the customer enters the IP, gateway and resolvers shown in the panel during setup.
Check afterwards
- Build a test server with each newly enabled template and check login, network and disk size.
- Rebuild the test server with another template to confirm reinstalls work.
Troubleshooting
- Template build hangs: the hypervisor could not download the image; check outbound access and disk space.
- Root password not accepted: cloud-init did not run; confirm the template is a supported cloud image.
- Disk not grown to plan size: the guest did not expand its partition; reboot once or grow it manually.
