Install Vagrant by following the instructions here: http://docs.vagrantup.com/v2/installation/. The latest Allura VM was built with Vagrant v1.1.5, so make sure you have that version or later.
Vagrant uses VirtualBox, so install that from https://www.virtualbox.org/
First, we'll create and boot the Allura VM. Note that this will download a large (~700MB) file
$ cd ~ && mkdir vagrant-allura && cd vagrant-allura $ git clone https://git-wip-us.apache.org/repos/asf/allura.git allura $ vagrant box add allura http://sourceforge.net/projects/allura/files/vagrant/allura-ubuntu-1204-server-amd64-20141217.box $ vagrant init allura $ vagrant up
Now that the VM is running, let's connect to it and start the Allura platform:
$ vagrant ssh # password is "vagrant" (env-allura)vagrant@vagrant-ubuntu-precise-64:~/src/allura$ ./update.sh ... lots of console output here ... ... its updating to the latest code & dependencies ... (env-allura)vagrant@vagrant-ubuntu-precise-64:~/src/allura$ ~/start_allura
That's it! Allura is running, and you can browse it from your host OS at http://localhost:8080. To log in as an admin, use username/password
vagrant sshconnects you to the VM, activates the Allura virtualenv, and puts you in the root of the Allura source tree, a git clone of our public repo.
update.shwill get the latest code and dependencies. This will get it current, even if the vagrant box was made a while ago.
~/start_allurais a helper script to make sure all Allura platform services are running. Run it as often as you like and it will do the right thing.
Vagrantfileby following these instructions: http://docs.vagrantup.com/v2/networking/forwarded_ports.html