Documentation
Complete guide to defining and managing KVM virtual machines with Ansible and libvirt.
- Getting Started — Install dependencies and create your first VM
- VM Definition — Configure VMs in
vms.csv - VM Lifecycle — List, start, stop, restart and destroy VMs
- Base Images — Download Linux and Windows base images
- Network — Bridge networking, DHCP and static IP
- Data Disks — Attach, resize and hot-plug data disks
- Snapshots — Create, restore and delete snapshots
- User Accounts — Create SSH users with passwordless sudo
- VM Console — VNC/SPICE and serial console access
- Remote Desktop — RDP access for Windows VMs
- Firewall — Managed nftables firewall
- macOS VMs — Hackintosh guests with keyboard-free boot
- macOS Base Image — How the macOS base image was built
Install dependencies and create your first KVM virtual machine.
Configure virtual machines as rows in vms.csv.
List, start, stop, restart, and destroy virtual machines.
Download Linux and Windows base images for VMs.
Bridge networking, DHCP, and static IP configuration for VMs.
Attach, resize, mount, and manage extra data disks.
Create, list, restore, and delete VM snapshots.
Create Linux user accounts with SSH key and passwordless sudo.
Access the VM display console via SPICE or VNC.
RDP access to Windows virtual machines.
Manage the host firewall with nftables on Debian and RedHat family hosts.
Run keyboard-free Hackintosh macOS guests alongside Linux and Windows VMs.
Build macos-sonoma-base.img from scratch with OSX-KVM on Debian 12.