diff --git a/README.rst b/README.rst
index 482602b..a01932f 100644
--- a/README.rst
+++ b/README.rst
@@ -55,4 +55,13 @@ Every option available in the templates can be set in pillar. Settings under 'sa
 
 ``Extending``
 =============
-Additional templates can be added by the user under salt/files/minion.d and master.d. This might be useful if, for example, a recently-added configuration option is not yet provided by the default template. 
+Additional templates can be added by the user under salt/files/minion.d and master.d. This might be useful if, for example, a recently-added configuration option is not yet provided by the default template.
+
+``Vagrant``
+===========
+
+Executing the provided `Vagrantfile <http://www.vagrantup.com/>`_  will create a Ubuntu 14.04 VM, add the default Saltstack Repository and install the current stable version.
+
+The folders inside the VM will be set up in a way that enables you to simply execute 'sudo salt "*" state.highstate' to apply the salt formula to the VM, using the pillar.example config. You can check /etc/salt/ for results.
+
+Remember, you will have to run ``state.highstate`` or ``state.sls salt.(master|minion|cloud)`` manually.