diff --git a/doc/source/index.rst b/doc/source/index.rst
index 0dd856b..5b8637b 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -14,6 +14,7 @@ Contents
 
    contributing
    quickstart
+   vagrant
    troubleshooting
    inventory_repo
    packer
diff --git a/doc/source/vagrant.rst b/doc/source/vagrant.rst
new file mode 100644
index 0000000..d47ec62
--- /dev/null
+++ b/doc/source/vagrant.rst
@@ -0,0 +1,16 @@
+===========================
+Vagrant for a quick dev env
+===========================
+
+Requirements:
+
+* Vagrant >= 1.8.5
+* Plugin vagrant-libvirt >= 0.0.35
+* Plugin vagrant-vbguest >= 0.13.0
+
+To start with defaults, just run ``vagrant up``. To tweak defaults, see the
+`vagrant-settings.yaml_defaults` file. You can rename the file as
+`vagrant-settings.yaml` end edit it to override defaults as well.
+
+.. note:: Make sure the default network choice doesn't conflict with existing
+     host networks!