Base Images
Linux Base Images
The Linux VMs use official cloud images pre-configured with cloud-init support.
Debian
Download the latest Debian 12 (Bookworm) image:
Alternative versions: Browse https://cloud.debian.org/images/cloud/ for bookworm, bullseye, trixie, etc.
Ubuntu
Download the latest Ubuntu 24.04 LTS (Noble) image:
Download the latest Ubuntu 26.04 LTS (Resolute) image:
Important: Ubuntu cloud images require the virtio network driver. The VM templates in this project already use virtio, so no additional configuration is needed.
Note: Always verify the downloaded image checksum against the official SHA256SUMS file to avoid corrupted images causing boot failures.
Alternative versions: Browse https://cloud-images.ubuntu.com/ for other Ubuntu releases.
Fedora
Download the latest Fedora 44 Cloud Base image:
Note: Fedora uses wheel group for sudo privileges (not sudo). The setup-user playbook automatically detects this and uses the correct group.
Alternative versions: Browse https://fedoraproject.org/cloud/download/ for other Fedora releases.
Rocky Linux
Download the latest Rocky Linux 10 Cloud Base image:
Note: Rocky Linux uses wheel group for sudo privileges (same as RHEL/CentOS). The setup-user playbook automatically detects this and uses the correct group.
Alternative versions: Browse https://rockylinux.org/download for other Rocky Linux releases.
Configuration
Set the image path in vms.csv base_image field:
The image is automatically configured via cloud-init on first boot (SSH keys, user, packages, etc. from group_vars/kvm_hosts/vms_all.yaml).
Windows Base Image
The Windows qcow2 base image is built with packer-windows-kubevirt. It uses Packer + QEMU to produce a sysprep-generalized Windows image with:
- virtio drivers pre-installed (vioscsi, viostor, netkvm, vioserial, viorng, balloon, viofs)
- QEMU Guest Agent + Cloudbase-Init
- WinRM HTTPS (port 5986) + RDP (port 3389) enabled
- EFI boot with secure boot keys
Build your own custom image:
Then set the output path in vms.csv base_image field.
Windows VM Features
When type=windows, the domain XML template includes:
- Hyper-V enlightenments (relaxed, vapic, spinlocks, synic, stimer, etc.) for nested WSL2
- VMX passthrough for nested virtualization (WSL2/Hyper-V inside guest)
- EFI + vTPM 2.0 (OVMF secure boot + emulated TPM)
- virtio-scsi disk bus + virtio NIC
- Localtime clock with hypervclock