diff --git a/README.rst b/README.rst
index 48a27feb31f8315cb2d77f49508a15859d0c789f..3087e99bb487d5911d9447384261216cc2ca5d58 100644
--- a/README.rst
+++ b/README.rst
@@ -1,13 +1,31 @@
 Ansible playbooks
-=================
+*****************
 
-My repository of Ansible playbooks and surronding infrastrcture. The actual
-roles are located in different repositories so they could be installed with
-ansible-galaxy.
+My homelab playground. A repository of infrastructure using Virtualbox, Vagrant,
+Landrush and Ansible. The actual Ansible roles are each located in a repository
+of its own (which is ansible-galaxy installable).
 
-todo
+
+Requirements
+------------
+
+- `Virtualbox <https://www.virtualbox.org/>`_.
+- `Vagrant <https://www.vagrantup.com/>`_.
+- `Landrush <https://github.com/phinze/landrush>`_.
+- `Ansible <http://www.ansible.com/>`_.
+
+Getting started
+---------------
+::
+
+    git clone https://www.shore.co.il/cgit/ansible-playbooks
+    cd ansible-playbooks
+    ansible-galaxy install -r requirements.yml
+    vagrant up
+
+
+TODO
 ----
 
-- Documentation?
-- Testing, pre-commit hooks.
+- Testing (maybe ansible-lint?).
 - Whatever automation not provided by Vagrant and Ansible.