diff --git a/README.md b/README.md
index 41ca018..2b588c2 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,34 @@
 NixOS boxes for Vagrant
 =======================
 
-First install packer: http://packer.io (or `brew install packer`)
+[NixOS](http://nixos.org) is a linux distribution based on a purely functional
+package manager. This project builds .box images that can be used by
+[vagrant](http://vagrantup.com), the VM manager.
+
+Status
+------
+
+stable
+
+Building the images
+-------------------
+
+First install [packer](http://packer.io) and
+[virtualbox](https://www.virtualbox.org/)
 
 Then:
 
 ```
-packer build --only=virtualbox nixos32-template.json
+packer build nixbox32-template.json
+# or
+packer build nixbox64-template.json
 ```
+
+The .box image is now ready to go and you can use it in vagrant:
+
+```
+vagrant box add nixbox32 nixbox32-virtualbox.box
+# or
+vagrant box add nixbox64-nixbox64-virtualbox.box
+```
+