1. Overview
  2. Why Vagrant?
  3. Introduction
  4. Project Setup
  5. Boxes
  6. SSH
  7. Provisioning
  8. Port Forwarding
  9. Packaging
  10. Teardown
  11. Rebuild Instantly

Warning!

Vagrant is beta software. Anything can change. Read more about our promise to backwards compatibility here.

Ubuntu

Installing Ruby

The easiest way to install Ruby and RubyGems is via Ubuntu’s built in package manager:

$ sudo aptitude install ruby1.8-dev ruby1.8 ri1.8 rdoc1.8 irb1.8 libreadline-ruby1.8 libruby1.8 libopenssl-ruby wget
$ sudo ln -s /usr/bin/ruby1.8 /usr/bin/ruby
$ sudo ln -s /usr/bin/ri1.8 /usr/bin/ri
$ sudo ln -s /usr/bin/rdoc1.8 /usr/bin/rdoc
$ sudo ln -s /usr/bin/irb1.8 /usr/bin/irb

Installing RubyGems

It is recommended that you install RubyGems from source. All the dependencies for RubyGems were installed above already so installing from source is fairly painless:

$ cd ~
$ wget http://production.cf.rubygems.org/rubygems/rubygems-1.3.7.tgz
$ tar xvzf rubygems-1.3.7.tgz
$ cd rubygems-1.3.7
$ sudo ruby setup.rb
$ sudo ln -s /usr/bin/gem1.8 /usr/bin/gem

You’ll also want to verify that RubyGems is fully updated, since the packages can often get out of date:

$ sudo gem update --system

VirtualBox OSE

By default, VirtualBox installed via Ubuntu’s package repositories will be “VirtualBox Open Source Edition (OSE).” Vagrant may work with this edition (as long as its version 3.1+), but it is not officially supported. It is recommended that you download the installation package from the VirtualBox website for the full version.