diff --git a/.gitignore b/.gitignore
index 2ebb1e9b34247c445520a8e53260f4e04601a92d..1f9359992fad786029c3cc7877c7031c99da0323 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 .vagrant
 *.retry
 inventory/vagrant_ansible_inventory
+temp
diff --git a/README.md b/README.md
index 0acb16c672c7b444562cf64974438a0fc5b809ea..f90a0ac0c1dc819d0d7232b2d726d58d22f0ef40 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 ![Kubespray Logo](http://s9.postimg.org/md5dyjl67/kubespray_logoandkubespray_small.png)
 
-##Deploy a production ready kubernetes cluster
+# Deploy a production ready kubernetes cluster
 
 - Can be deployed on **AWS, GCE, OpenStack or Baremetal**
 - **High available** cluster
@@ -10,12 +10,61 @@
 - Support most popular **Linux distributions**
 - **Continuous integration tests**
 
+# Getting Started
 
 To deploy the cluster you can use :
 
-* [**kargo-cli**](https://github.com/kubespray/kargo-cli)
-* **vagrant** by simply running `vagrant up`
-* **Ansible** usual commands
+## kargo-cli
+
+[**kargo-cli**](https://github.com/kubespray/kargo-cli)
+ 
+## Vagrant
+
+Assuming you have Vagrant (1.8+) installed with virtualbox (it may work
+with vmware, but is untested) you should be able to launch a 3 node 
+Kubernetes cluster by simply running `$ vagrant up`.
+
+This will spin up 3 VMs and install kubernetes on them.  Once they are 
+completed you can connect to any of them by running 
+`$ vagrant ssh k8s-0[1..3]`.
+
+```
+$ vagrant up
+Bringing machine 'k8s-01' up with 'virtualbox' provider...
+Bringing machine 'k8s-02' up with 'virtualbox' provider...
+Bringing machine 'k8s-03' up with 'virtualbox' provider...
+==> k8s-01: Box 'bento/ubuntu-14.04' could not be found. Attempting to find and install...
+...
+...
+    k8s-03: Running ansible-playbook...
+
+PLAY [k8s-cluster] *************************************************************
+
+TASK [setup] *******************************************************************
+ok: [k8s-03]
+ok: [k8s-01]
+ok: [k8s-02]
+...
+...
+PLAY RECAP *********************************************************************
+k8s-01                     : ok=157  changed=66   unreachable=0    failed=0   
+k8s-02                     : ok=137  changed=59   unreachable=0    failed=0   
+k8s-03                     : ok=86   changed=51   unreachable=0    failed=0   
+
+$ vagrant ssh k8s-01
+vagrant@k8s-01:~$ kubectl get nodes
+NAME      STATUS    AGE
+k8s-01    Ready     45s
+k8s-02    Ready     45s
+k8s-03    Ready     45s
+```
+
+
+## Ansible
+
+**Ansible** usual commands
+
+# Further Reading
 
 A complete **documentation** can be found [**here**](https://docs.kubespray.io)
 
diff --git a/Vagrantfile b/Vagrantfile
index 288ad5be006a99816605ecb08fb5942ce0265827..e32ced39f0a8deb11187c282b59694d7e3aaecd0 100644
--- a/Vagrantfile
+++ b/Vagrantfile
@@ -11,11 +11,12 @@ CONFIG = File.join(File.dirname(__FILE__), "vagrant/config.rb")
 $num_instances = 3
 $instance_name_prefix = "k8s"
 $vm_gui = false
-$vm_memory = 1024
+$vm_memory = 1536
 $vm_cpus = 1
 $shared_folders = {}
 $forwarded_ports = {}
 $subnet = "172.17.8"
+$box = "bento/ubuntu-14.04"
 
 host_vars = {}
 
@@ -40,22 +41,7 @@ end
 Vagrant.configure("2") do |config|
   # always use Vagrants insecure key
   config.ssh.insert_key = false
-
-  config.vm.box = "ubuntu-14.04"
-  config.vm.box_url = "https://storage.googleapis.com/%s.release.core-os.net/amd64-usr/%s/coreos_production_vagrant.json" % [$update_channel, $image_version]
-
-  ["vmware_fusion", "vmware_workstation"].each do |vmware|
-    config.vm.provider vmware do |v, override|
-      override.vm.box_url = "https://storage.googleapis.com/%s.release.core-os.net/amd64-usr/%s/coreos_production_vagrant_vmware_fusion.json" % [$update_channel, $image_version]
-    end
-  end
-
-  config.vm.provider :virtualbox do |v|
-    # On VirtualBox, we don't have guest additions or a functional vboxsf
-    # in CoreOS, so tell Vagrant that so it can be smarter.
-    v.check_guest_additions = false
-    v.functional_vboxsf     = false
-  end
+  config.vm.box = $box
 
   # plugin conflict
   if Vagrant.has_plugin?("vagrant-vbguest") then
@@ -92,7 +78,8 @@ Vagrant.configure("2") do |config|
         "ip" => ip,
         "access_ip" => ip,
         "flannel_interface" => ip,
-        "flannel_backend_type" => "host-gw"
+        "flannel_backend_type" => "host-gw",
+        "local_release_dir" => "/vagrant/temp"
       }
       config.vm.network :private_network, ip: ip