Vagrant setup

We are using a vagrant box to provide a quick development environment for you to get started with. You will need

[Vagrant](https://www.vagrantup.com/) >= 5.1.10
[VirtualBox](https://www.virtualbox.org/) >= 4.3

To setup the vagrant virtual machine, from beavy root run:

vagrant up --provision

When run for the first time, this might take a while as vagrant has to download the latest version of the virtual box image. Once this is done and everything has been set up, you should see a big green message welcoming you and asking you to run start.sh. Before you can do that, make sure you properly set up your own app!

Troubleshooting

Hangs when installing vbGuest

If your vagrant up --provision hangs at

Copy iso file /Applications/VirtualBox.app/Contents/MacOS/VBoxGuestAdditions.iso into the box /tmp/VBoxGuestAdditions.iso

This is due to the vbguest plugin – which interferes with the jessie64 image provided. Please kill the process (CTRL+C, pkill vagrant), stop the system (vagrant halt -f), uninstall vbguest (vagrant plugin uninstall vagrant-vbguest)** and restart provisioning. You might encounter an error message at the beginning warning you that the guest-tools aren’t up to date, but you can ignore that!