No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Try BusterJS! No Maintenance Intended

This project aims to provide you with an easy way of trying out BusterJS, to see if it's to your liking.

With a modern(ish) computer and a decent internet connection, you should be up and running in about 5-10 minutes, most of that time you can spend on YouTube, Facebook, Minecraft, etc.

Together, we will build a little virtual machine that has everything needed to run BusterJS, without you having to worry about compiling nodejs locally or disrupting your current nodejs install.


  • A working ruby install on your host operating system. 1.8.7, 1.9.2 are both fine. (OSX default is fine)
  • Vagrant gem installed. Make sure you install lucid32 as base box
  • Oracle VirtualBox installed (4.1.0+) download
  • A working SSH install on your host operating system. Linux and OSX has this builtin, Windows users should refer to
  • Some disk space (the base box and installed vm shouldn't use more than 1GB)

Getting started - building the VM

git clone
cd try-busterjs
vagrant up

Now go watch some videos on YouTube, while we bake your new VM.

Running tests

Once the VM has been built locally, you can log in to it and run tests. For this you will need two ssh connections to the VirtualBox

First ssh session for running Buster's serverStart Buster's server in the virtual machine.

vagrant ssh
buster server

Now you can capture your favourite browsers by pointing them at http://localhost:1111/capture

In the second ssh session we run the test suite.

vagrant ssh
cd /vagrant/project
buster test

You should see something like this

Safari 5.1.2 OS X: ..
1 test case, 2 tests, 2 assertions, 0 failures, 0 errors, 0 timeouts


Now that you have a VM capable of running BusterJS, it's time to for you to explore.

To edit the files in the project, you can just use your favourite editor(s). The root of the project gets mapped into the VM as /vagrant, where buster can work with the files.


	| Host                 | Guest            |
	| try-busterjs         | /vagrant         |
	| try-busterjs/project | /vagrant/project |

I am sure you get the idea.