Vagrant

You can test deployment (or do all development) on a Vagrant box. This is highly recommended if you are trying to test deployment changes or are altering packages which may behave differently on your development system from the target production environment.

First, you'll need to install vagrant:

$ cd barkeep
$ git submodule init && git submodule update && bundle install

Next, the setup_vagrant.rb script will download the Vagrant Ubuntu image if you don't have it already, and set up passwordless ssh to the Vagrant VM.

$ script/vagrant_quick_start.rb
$ ssh barkeep_vagrant 'echo hello' # Test that it's working -- you should see 'hello' printed

If you fall into trouble you with bundler version, try to install the necessary version of bundler

$ gem uninstall bundler && gem install bundler -v 1.10.6

Now you can deploy Barkeep to the vagrant box:

$ bundle exec fez vagrant deploy

If everything's working, you should be able to check Barkeep at http://localhost:8080. Next you'll want to start watching some repositories; see Viewing repositories for instructions.

You can shut down the Vagrant VM using bundle exec vagrant halt, and destroy it completely using bundle exec vagrant destroy.

Ready to run Barkeep in your organization? Head over to Installing Barkeep.