Skip to content
Virtual development environment for any Ruby project with 1 command
Branch: master
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.


Virtual development environment for any Ruby project with 1 command


  • automatic installation and setup (for details see Installed tools)
    • RVM, Ruby and Bundler
    • IDEs
    • project dependencies
    • popular tools
  • easy integration, doesn't interfere with base project
  • smart resource allocation based on the host system's available resources*
  • any host and any Ubuntu / Debian guest system**
  • base project is synchronized and available on both host and guest systems

* all virtual CPU cores, 1/4th of memory (via vagrant-faster)

** tested on Ubuntu 14.04 LTS, slight alterations may be needed for other systems


Vagrant (tested on 1.9.3)

VirtualBox (tested on 5.1.18)

Some vagrant plugins:

vagrant plugin install vagrant-proxyconf vagrant-vbguest vagrant-faster


Checkout this project to a Ruby project's root in it's own subdirectory (e.g. <project_root>/ruby-devenv) and keep it up to date. Using git this can easily be achieved via submodules:

git submodule add
git submodule update --remote ruby-devenv

More info on git submodules here. An example of ruby-denenv used as a submodule can be found here.


Inside ruby-devenv's directory execute

vagrant up

Wait for the setup to finish (indicated by Provision executed in %hh-%mm-%ss). If you encounter issues during the first setup (e.g. with UI) try to restart the VM.

Manage the box via vagrant CLI or VirtualBox.

Manual steps

  • Configure git
git config --global ""
git config --global ""
  • Configure access via keys (e.g. to github)
cat ~/.ssh/


Highly depends on the host system. Test system: i5-6500 CPU | 16 GB RAM | 500 Mbps Network | SSD

  • Initial host setup ~ 3 minutes (1 time)

  • Initial guest setup ~ 10-15 minutes (1 time / VM)

    • ~3-5 minutes of that is installing ubuntu-desktop which could be bypassed with an ideal Vagrant Box (more in the Boxes section).
  • Guest boot ~ 30 seconds (every time)

Technical details


Currently using official ubuntu/trusty64 box.

Many Vagrant boxes are available in Atlas. Ideally we'd use ubuntu/xenial64-desktop however there're several issues:

Installed tools

All tool are installed with latest stable version available unless indicated otherwise

  • RVM, Ruby, Bundler

  • RubyMine, Sublime Text, Visual Studio Code

  • Git, tree, umake, expect, nautilus-open-terminal, snap, heroku CLI

  • VirtualBox Guest Additions

  • Base project's gem dependencies (assuming directory structure defined in Setup)


VM setup with ansible instead of bash:

Known issues

  • expect timeout doesn't return error
  • During umake install:
    • dconf-WARNING **: failed to commit changes to dconf: Cannot autolaunch D-Bus without X11 $DISPLAY
    • Possibly related to shortcuts not created
  • install of build-essential linux-headers-$(uname -r) virtualbox-guest-x11 needed, otherwise Unity issue presents
  • bunch of unnecessary output (no quiet mode for RVM, umake, etc)
You can’t perform that action at this time.