Using Vagrant

We use Vagrant to provide a preconfigured development environment for cmdr.

To get started, install the latest version of Vagrant and install the latest version of VirtualBox as well.

First, we're going to install a vagrant plugin that will prevent some issues from occurring:

vagrant plugin install vagrant-vbguest

This plugin ensures that the box you're running always has the latest VirtualBox Guest Additions, which can help ensure the box starts up normally if it's using an older version of guest additions.

To actually install our box, we're going to two commands that will automatically download our base box from Vagrant Cloud and provision it appropriately:

vagrant init wesleyan/cmdr
vagrant up

Grab a cup of coffee and wait for it to download, install and update the VB guest additions. Once it's finished, we'll connect to the box:

vagrant ssh

Our Vagrantfile fowards internal ports so that they are accessible outside of Vagrant on your local host:

• You can access CouchDB on port 5985
• You can access the cmdr web interface on port 8080
• You can access websockets on port 8085
• You can access cmdrHTTP on port 1415