Skip to content

KVM virtual machine management

ansible-vms Declare VMs in a CSV

Define KVM guests as rows in vms.csv and let Ansible and libvirt handle the rest — cloud images, bridges, snapshots, data disks, console access and firewalls, reproducibly and idempotently.

Key features

Everything you need

Quick Start

Clone the repo, copy the example configs, and create your first VM in minutes.

Quick Start

VM Lifecycle

Start, stop, restart and destroy VMs; every playbook is idempotent and safe to re-run.

VM Lifecycle

Networking

Bridge networking with DHCP or static addresses, cloud-init network config included.

Networking

Storage & Disks

Attach, resize and hot-plug data disks; build the disk layout from a single CSV row.

Storage & Disks

macOS VMs

Hackintosh guests with blessed NVRAM and keyboard-free boot.

macOS VMs

Firewall

Managed nftables firewall for Debian, Ubuntu, Fedora and Rocky hosts, with ufw and firewalld disabled.

Firewall

Snapshots

Create, restore and delete libvirt snapshots of running or stopped VMs.

Snapshots

Base Images

Download and prepare Debian, Ubuntu, Fedora, Rocky and Windows cloud images.

Base Images

Ready to get started?Install the dependencies, copy the example configs and create your first VM in minutes.