Index: /main/waeup-ansible/README.rst
===================================================================
--- /main/waeup-ansible/README.rst	(revision 13822)
+++ /main/waeup-ansible/README.rst	(revision 13823)
@@ -1,4 +1,66 @@
-Playbooks for administrating WAeUP servers.
-===========================================
+=============================================
+ Playbooks for administrating WAeUP servers.
+=============================================
 
 These are materials to use with our servers.
+
+For starters: the tutorial given on
+
+  https://github.com/leucos/ansible-tuto
+
+is a really nice hands-on intro to `ansible`. Please read it!
+
+Vagrant
+=======
+
+In `Vagrantfile` we set up a vagrant environment which provides three
+hosts as virtualbox:
+
+  ``vh5.sample.org``, ``vh6.sample.org``, ``vh7.sample.org``
+
+running Ubuntu 14.04. ``vh5`` represents "virtual host 5" and should
+reflect h5.waeup.org. The same holds for ``vh6`` and ``vh7``
+accordingly.
+
+The three virtual hosts are for testing any upcoming ansible
+playbooks. They should be used before running playbooks on the real
+hosts!
+
+
+Initialize Vagrant Env
+----------------------
+
+You must have `vagrant` installed, if possible in a fairly recent
+version. I (uli) use `vagrant 1.8.1` (latest as time of writing).  As
+Ubuntu 14.04 is pretty outdated in that respect, I had to grab a .deb
+package from
+
+  https://www.vagrantup.com/downloads.html
+
+that could be installed with::
+
+ $ sudo dpkg -i vagrant_1.8.1_x86_64.deb
+
+
+When everything is in place, change into this directory and run::
+
+  $ vagrant up
+  Bringing machine 'vh5' up with 'virtualbox' provider...
+  Bringing machine 'vh6' up with 'virtualbox' provider...
+  Bringing machine 'vh7' up with 'virtualbox' provider...
+  ==> vh5: Importing base box 'ubuntu/trusty32'...
+  ...
+
+This will fetch Vagrant virtualbox images for trusty32, i.e. Ubuntu
+14.04 images, 32bit version (plays nice also on 64bit hosts).
+
+All three hosts provide ssh access via::
+
+  $ vagrant ssh vh0
+
+or equivalent commands. They have a user 'vagrant' installed, which
+can sudo without password.
+
+You can halt (all) the virtual hosts with::
+
+  $ vagrant halt
Index: /main/waeup-ansible/Vagrantfile
===================================================================
--- /main/waeup-ansible/Vagrantfile	(revision 13823)
+++ /main/waeup-ansible/Vagrantfile	(revision 13823)
@@ -0,0 +1,22 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+hosts = {
+  "vh5" => "192.168.36.10",
+  "vh6" => "192.168.36.11",
+  "vh7" => "192.168.36.12"
+}
+
+Vagrant.configure("2") do |config|
+  hosts.each do |name, ip|
+    config.vm.define name do |machine|
+      machine.vm.box = "ubuntu/trusty32"
+      machine.vm.hostname = "%s.sample.org" % name
+      machine.vm.network :private_network, ip: ip
+      machine.vm.provider "virtualbox" do |v|
+          v.name = name
+          v.customize ["modifyvm", :id, "--memory", 200]
+      end
+    end
+  end
+end
