= kvm-manager =

We use [https://0xacab.org/dkg/kvm-manager kvm-manager] to create, start and stop virtual guests.

Starting with `stretch`, we are using the new systemd tools in kvm-manager which are documented below.

 * Add guest user to the kvm group. I'm not sure why this is now required so have not automated it yet...
{{{
adduser $guest kvm
}}}

 * Start a guest: `systemctl start kvm@$guest.service`
 * Stop a guest: `systemctl stop kvm@$guest.service` (command will wait until service exits)
 * Enable a guest to start at boot time: `systemctl enable kvm@$guest.service`
 * Prevent a guest from starting at boot time: `systemctl disable kvm@$guest.service`
 * Debug: `journalctl -u kvm@$guest.service`

To test out process manually:

As root:
{{{
kvm-setup $guest
}}}

As the guest user:
{{{
kvm-start $guest
kvm-stop $guest
}}}

As root:
{{{
kvm-teardown $guest
}}}