doc: point at libvirt setup help

1 files changed, 24 insertions, 0 deletions

diff --git a/README.md b/README.md
index 5525589..7c56cec 100644
--- a/README.md
+++ b/README.md
@@ -139,3 +139,27 @@ where `XXX` is the public key part of the CA key, as stored in
 `~/.ssh/ca/vmadm_ca.pub` in the example above. This tells your client
 that the CA key on the line should be accepted for all hosts (`*`).
 You can restrict it to only some hosts if you prefer.
+
+# Setup of host
+
+The host where vmadm is run needs to have libvirt running and you must
+have access to the `qemu:///system` connection.
+The Debian wiki has some useful documentation: 
+
+* <https://wiki.debian.org/libvirt>
+* <https://wiki.debian.org/KVM>
+
+I set up my own libvirt hosts using an Ansible role:
+<http://git.liw.fi/ansibleness/tree/ansible/roles/vmhost>. It works on
+Debian. The short version:
+
+* install
+  - `libvirt` (Debian packages `libvirt-daemon-system`,
+    `libvirt-daemon`, `libvirt-daemon`)
+  - `virt-install` (Debian package `virtinst`)
+  - `qemu-img` (Debian package `qemu-uttils`)
+  - NSS lookups for VMs (Debian package `libnss-libvirt`)
+  - SSH client (Debian package `openssh-client`)
+* make sure you are in the `libvirt` group
+* edit `/etc/nsswitch.conf` to have `libvirt libvirt_guest` in the
+  `hosts` line