diff --git a/test/README.md b/test/README.md
index 9d7cbdc7..4e18f175 100644
--- a/test/README.md
+++ b/test/README.md
@@ -6,13 +6,21 @@ You need two VMs with docker >=1.3.1 installed and listening on TCP
 port 2375 (see below). You also need to be able to ssh to these VMs,
 preferably without having to input anything.
 
-The `Vagrantfile` in this directory constructs two such VMs. To meet
-the aforementioned ssh requirement you may want to
+The `Vagrantfile` in this directory constructs two such VMs.
+
+To create the VMs, open a shell and in this directory and type
+
+    vagrant up
+
+To meet the aforementioned ssh requirement you may want to
 
     cp ~/.vagrant.d/insecure_private_key .
 
 ## Running tests
 
+If you are [building weave using Vagrant](http://docs.weave.works/weave/latest_release/building.html),
+it is recommended to run the tests from the build VM and not the host.
+
     ./setup.sh
 
 uploads the weave images from where the Makefile puts them