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 path/to/barkeep/project/root
$ 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/setup_vagrant.rb
$ ssh barkeep_vagrant 'echo hello' # Test that it's working -- you should see 'hello' printed

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.

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 Deploying Barkeep.