This repository has been archived by the owner. It is now read-only.
A drop-in Vagrant box for Ruby projects.
Ruby Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Corundum is a bare-bones Vagrant box for Ruby / Ruby on Rails projects.

It uses VirtualBox as a provider and is provisioned with Chef.

It aims to provide only the absolute bare essentials to get someone working on a Rails project on any Vagrant/VirtualBox-supported platform.

What you get:

The box is based on the (Ubuntu 12.04) provided by Vagrant (see:


  • Latest RVM
  • git
  • oh-my-zsh
  • Ruby v2.1.1
  • MySQL v5.5.29
  • Password is defaulted to 'vagrant' for root user

Getting Started

Assuming you've already installed Vagrant and VirtualBox, in order to prepare corundum for use on your system:

  1. Clone the repo
git clone git://
  1. Install gems
bundle install
  1. Fetch cookbooks
librarian-chef install
  1. Provision the VM
vagrant up
  1. Package the VM as a box
vagrant package --vagrantfile Vagrantfile.pkg

This will create in your working directory. This file can be distributed to your team directly so they can skip steps 1-5.

The Vagrantfile.pkg ensures the box is packaged with network configuration and folder syncing that would always need to be in the client Vagrantfile

  1. Add the packaged VM to Vagrant for future use
vagrant box add --name brrygrdn/corundum
  1. Cleanup

Before provisioning a corundum-based VM in one of your projects, make sure you tear down the VM used to create the packaged version by going to your working directory for this repo and running:

vagrant halt

This ensures forwarded ports are free for new VMs.

Using Corundum in a project

To use corundum as a base-box for your project:

  1. Add it to your available boxes in Vagrant
vagrant box add brrygrdn/corundum

You can check which boxes you have installed with

vagrant box list
  1. Initialise Vagrant for your project
cd my_project
vagrant init
  1. Edit the generated Vagrantfile to include the line = "brrygrdn/corundum"
  1. Provision your project's VM
vagrant up

Make sure to add /.vagrant to your .gitignore so you don't checkin its cache file.

Accessing the VM

Once provisioning is complete, access your VM by running vagrant ssh

You can shut down the image with vagrant halt

If you've made a mistake or are finished using the VM, run vagrant destroy to remove it.

You can open the VirtualBox Manager to see any VMs installed by Vagrant if in doubt.

Where's my stuff?

Your working directory will be available inside your VM at ~/my_project

Rails, MySQL and other services are available on your host machine through a series of port-forwards. You can see the default forwards in Vagrantfile.pkg.

As an example:

  1. SSH into your VM
vagrant ssh
  1. Start a rails server
cd my_project
rails server
  1. Point your browser at localhost:3030 to see your app.


You can override many of the default settings of a new corundum-based box in your own project's Vagrantfile. See examples/Vagrantfile for some hints.

Corundum only provides the basics for a Ruby / Rails project, you may need to provision some other depenancies yourself. These can be added to your own Vagrantfile using chef / puppet or shell provisioning.

See the Vagrant docs for more information.

If you are using Chef, I recomemend using Librarian to manage your cookbooks so you don't need to check them into your project or use git submodules.


In order to contribute:

  1. Fork the repo
  2. Create a branch
  3. Make your changes
  4. Push your branch
  5. Submit a pull request