1. RBenv



RBENV allows the user to select a particular version of Ruby to use on their development machine. To install run this:

$ brew install rbenv ruby-build

To use Homebrew's directories rather than ~/.rbenv add export RBENV_ROOT=/usr/local/var/rbenv

To enable shims and autocompletion add to your profile: if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi

Add the init to the profile script with the following command

$ echo 'eval "$(rbenv init - --no-rehash)"' >> ~/.zshrc


To see what RBENV ruby versions are available run :

$ rbenv install --list

Install the desired Ruby version, make global and run a rehash.

$ rbenv install 2.3.0
$ rbenv local   2.3.0
$ rbenv global  2.3.0
$ rbenv rehash
$ rbenv local 2.3.0 && rbenv global 2.3.0 && rbenv rehash

To reset it back to the system use :

$ rbenv global system

Restarting the terminal and running

$ ruby -v

Should show that you are indeed running the version that was just installed.


Finding out where the gems are installed is as simple as running a which on a Gem that you know is installed

$ gem list
$ gem which middleman


Core folder, based on the version installed :

$ cd ~/.rbenv/versions/2.3.0/

Update Gems

$ gem update --no-ri --no-rdo --system
$ gem update --no-ri --no-rdo
$ gem clean

$ gem install --no-ri --no-rdoc bundler
$ gem install --no-ri --no-rdoc thor

$ rbenv rehash


To remove RBENV, remove the folder and the brew module

$ rm -rf ~/.rbenv
$ brew uninstall rbenv

Also delete all entries from your system configuration files

$ grep rbenv ~/.bashrc ~/.bash_profile ~/.zshrc /etc/profile /etc/profile.d/*
  • https://robots.thoughtbot.com/using-rbenv-to-manage-rubies-and-gems
  • https://github.com/ianheggie/rbenv-binstubs