You may prefer to use Docker instead of Vagrant. See https://forge-allura.apache.org/p/allura/git/ci/master/tree/INSTALL-docker.markdown
The Vagrant images for Allura have not been updated for some time.
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 root/foo
.
vagrant ssh
connects 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.sh
will get the latest code and dependencies. This will get it current, even if the vagrant box was made a while ago.~/start_allura
is 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.Vagrantfile
by following these instructions: http://docs.vagrantup.com/v2/networking/forwarded_ports.html