Clone this wiki locally
rbenv is a tool for simple Ruby version management.
To install rbenv, please refer to the Readme.
Troubleshooting / FAQ
How is this better than RVM?
See Why rbenv?
What is allowed in a
The string read from a
.ruby-version file must match the name of an existing
~/.rbenv/versions/. You can see the list of installed Ruby
Other version managers might allow fuzzy version matching on the string read
.ruby-version file, e.g. they might allow "1.9.3" (without patch suffix)
to match the latest Ruby 1.9.3 release. rbenv will not support this, because
such behavior is unpredictable and therefore harmful.
How to verify that I have set up rbenv correctly?
rbenvis in your PATH:
Check that rbenv's shims directory is in PATH:
echo $PATH | grep --color=auto "$(rbenv root)/shims"
If not, see the
rbenv initstep in installation instructions.
rbenv is installed but things just aren't working for me!
Please search existing issues and open a new one if you had problems using rbenv.
Which shell startup file do I put rbenv config in?
Typically it's one of the following:
~/.bashrcon Ubuntu Desktop)
See Unix shell initialization for more info about how config files get loaded.
gem isn't working! It keeps using the system gem/ruby/rake/irb.
Did you remember to rehash?
$ rbenv install -v 2.5.0 $ rbenv global 2.5.0 $ rbenv rehash $ gem install bundler $ rbenv rehash
It would be wise to
rbenv rehash after any install && global and after any