I need to update my Ruby version from 2.0.0 to the latest version. I can not use some gems because my version is not updated. I had used Homebrew to install Ruby some time ago. How can I update my Ruby version?
15 Answers
Open your terminal and run
curl -sSL https://raw.githubusercontent.com/rvm/rvm/master/binscripts/rvm-installer | bash -s stable
For the rvm
command to work, you need to run:
source ~/.rvm/scripts/rvm
Now, run rvm list known
This shows the list of versions of the Ruby interpreter.
Now, run rvm install ruby@latest
to get the latest Ruby version.
If you type ruby -v
in the terminal, you should see ruby X.X.X
.
If it still shows you ruby 2.0.
, run rvm use ruby-X.X.X --default
.
Prerequisites for Windows 10:
- C compiler. You can use http://www.mingw.org/
make
command available otherwise it will complain that "bash: make: command not found". You can install it by runningmingw-get install msys-make
- Add "C:\MinGW\msys\1.0\bin" and "C:\MinGW\bin" to your path environment variable
Homebrew-only solution
A better solution
From the comments (kudos to Maksim Luzik), I haven't tested but seems like a more elegant solution:
After installing Ruby through brew, run the following command to update the links to the latest Ruby installation:
brew link --overwrite ruby
A solution
Using brew is enough. It's not necessary to install rvm and for me it just complicated things.
By brew install ruby
you're actually installing the latest (currently v2.4.0). However, your path finds 2.0.0 first. To avoid this just change precedence (source). I did this by changing ~/.profile
and setting:
export PATH=/usr/local/bin:$PATH
After this, I found that the bundler gem was still using version 2.0.0. Just install it again: gem install bundler
-
8Exactly what I was looking for, thanks. If I was a ruby dev then rvm would make sense, but I'm not, so this is perfect.– MaxJun 23, 2017 at 3:17
-
4
-
12or after installing ruby through brew, run following command to update the links to the latest ruby installation:
brew link --overwrite ruby
Aug 31, 2017 at 14:41 -
2instead of
overwrite
ruby version, you can just writebrew unlink ruby && brew link ruby
Nov 2, 2017 at 15:25 -
15@MaksimLuzik 's solution does not work for me in MacOS.
brew link --overwrite ruby
leads toWarning: Refusing to link macOS-provided software: ruby
Jul 3, 2019 at 7:42
I recommend rbenv* https://github.com/rbenv/rbenv
* If this meets your criteria: https://github.com/rbenv/rbenv/wiki/Why-rbenv?:
rbenv does…
- Provide support for specifying application-specific Ruby versions.
- Let you change the global Ruby version on a per-user basis.
- Allow you to override the Ruby version with an environment variable.
In contrast with RVM, rbenv does not…
- Need to be loaded into your shell. Instead, rbenv's shim approach works by adding a directory to your
$PATH
.- Override shell commands like
cd
or require prompt hacks. That's dangerous and error-prone.- Have a configuration file. There's nothing to configure except which version of Ruby you want to use.
- Install Ruby. You can build and install Ruby yourself, or use ruby-build to automate the process.
- Manage gemsets. Bundler is a better way to manage application dependencies. If you have projects that are not yet using Bundler you can install the rbenv-gemset plugin.
- Require changes to Ruby libraries for compatibility. The simplicity of rbenv means as long as it's in your
$PATH
, nothing else needs to know about it.
Installation
Install Homebrew http://brew.sh
Then:
brew update
brew install rbenv ruby-build
# Add rbenv to Bash so that it loads every time you open a terminal
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
source ~/.bash_profile
rbenv install --list
Output:
Available versions:
1.8.5-p113
1.8.5-p114
[…]
2.3.1
2.4.0-dev
jruby-1.5.6
[…]
And:
rbenv install 2.3.1
Set the global version:
rbenv global 2.3.1
ruby -v
Output:
ruby 2.3.1p112 (2016-04-26 revision 54768) [x86_64-darwin15]
If you are not showing the updated version then
rbenv rehash
Set the local version of your repository by adding .ruby-version
to your repository's root directory:
cd ~/whatevs/projects/new_repo
echo "2.3.1" > .ruby-version
For OS X, visit this link.
-
3@ChuchaC No prob. But before you do, this is from the rbenv readme: "Compatibility note: rbenv is incompatible with RVM. Please make sure to fully uninstall RVM and remove any references to it from your shell initialization files before installing rbenv." — github.com/rbenv/rbenv#installation Jul 6, 2016 at 2:33
-
21didn't helped. Still getting standard 2.0.0 version for
ruby -v
afterrbenv global ...
Sep 8, 2016 at 10:57 -
11There's one additional step after
brew install rbenv
Runrbenv init
and add one line to .bash_profile as it states. After that reopen your terminal window, dorbenv install 2.3.1
,rbenv global 2.3.1
and rbenv will do its work– SGISep 30, 2016 at 12:01 -
8Probably late but for future references for people who encountered the same issue as @tuxSlayer ,
rbenv rehash
afterrbenv global
worked for me– SeanFeb 1, 2017 at 3:01 -
2After
rbenv init
,ruby -v
outputs the correct version 2.1.2, but bundle runs encounters some error like thispaperclip-5.0.0.beta1 requires ruby version >= 2.1.0, which is incompatible with the current version, ruby 2.0.0p648
. Finally manage to get it work with a run ofrbenv rehash
. Thanks @Sean– JamesApr 14, 2017 at 3:43
Open Terminal:
sudo gem update --system
It works!
-
4This does indeed seem to work, and is a unmeasurably more straight forward than the other answers. But when installing some gems (listen for example) they complain that the version is lower than required. Nov 9, 2016 at 9:38
-
13
-
-
6I was misled by this answer too. It "works" in that no errors are generated when you run it from the console. However, it does not update Ruby. It updates Ruby Gems. Follow one of the other answers to update Ruby (using OS X Sierra). Aug 14, 2017 at 19:40
-
Tried it, but i got the following error:
ERROR: Error installing rubygems-update: rubygems-update requires Ruby version >= 2.3.0. ERROR: While executing gem ... (NoMethodError) undefined method `version' for nil:NilClass
– ciurlaroJul 20, 2020 at 13:26
A fast way to upgrade Ruby to v2.4+
brew upgrade ruby
or
sudo gem update --system
-
8This appears to do a ton of stuff, but upgrading ruby isn't one of them. It terminates with:
/usr/local/Homebrew/Library/Homebrew/brew.rb:12:in '<main>': Homebrew must be run under Ruby 2.3! You're running 2.0.0. (RuntimeError)
– nkorenJan 5, 2018 at 16:06 -
1This is the correct and best way to upgrade ruby version using brew. Apr 23, 2018 at 20:12
-
3Doesn't work for me.
ERROR: While executing gem ... (Errno::EPERM) Operation not permitted @ rb_sysopen - /System/Library/Frameworks/Ruby.framework/Versions/2.3/usr/bin/gem
Mar 20, 2020 at 10:14 -
1@SébastienLoisel can you please give some detail about your OS, command etc. Mar 20, 2020 at 10:15
-
1@fatihyildizhan apparently ruby/gems/etc is in a semibroken state on Mavericks. I've resolved my issues by upgrading to Catalina. I don't remember all the errors I had, but there were multitudes. I can't remember if I was trying to upgrade cocoapods or gems or what, but it was essentially hopeless. Mar 21, 2020 at 14:05
You can specify the latest version of Ruby by looking at Download Ruby.
Fetch the latest version:
curl -sSL https://get.rvm.io | bash -s stable --ruby
Install it:
rvm install 2.2
Use it as default:
rvm use 2.2 --default
Or run the latest command from ruby:
rvm install ruby --latest
rvm use 2.2 --default
Use:
brew install rbenv ruby-build
Add rbenv to Bash so that it loads every time you open a terminal:
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
source ~/.bash_profile
Install Ruby
rbenv install 2.6.5
rbenv global 2.6.5
ruby -v
Link to the source page.
✅ Working 2023 method:
Upgrade using Homebrew:
brew upgrade ruby
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
brew link --overwrite ruby
Then restart the Terminal (make sure you terminate all instances, quit and open again)
Then ruby -v
to check if it linked correctly.
💡Recommended Followup:
It's not required, but you can run the following after upgrading Ruby to update gem files:
gem update --system 3.4.2
⚠️ The above version may be changed when you have upgraded your Ruby installation. Please use the correct version as reported after the installation of Ruby.
-
1this assumes zshell, which while the default shell on newer macs, many still use bash. Nov 15 at 20:05
In case of the error “Requirements installation failed with status: 1.”, here's what to do:
Install Homebrew (for some reason it might not work automatically) with this command:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Then proceed to install rvm again using
curl -sSL https://get.rvm.io | bash -s stable --ruby
Quit, reopen Terminal, and then:
rvm install 2.2
rvm use 2.2 --default
In a terminal: rvm gemset use global
-
9While this code snippet may be the solution, including an explanation really helps to improve the quality of your post. Remember that you are answering the question for readers in the future, and those people might not know the reasons for your code suggestion.– AdamApr 13, 2017 at 15:21
I ended up using the steps below due to React Native 0.70 and macOS v12 (Monterey).
brew install ruby
Edit .zshrc:
open -e ~/.zshrc
Set the $PATH environment variable. Add this at the end of your ~/.zshrc file. On Mac Intel:
if [ -d "/usr/local/opt/ruby/bin" ]; then
export PATH=/usr/local/opt/ruby/bin:$PATH
export PATH=`gem environment gemdir`/bin:$PATH
eval "$(rbenv init -)"
fi
Apple silicon
if [ -d "/opt/homebrew/opt/ruby/bin" ]; then
export PATH=/opt/homebrew/opt/ruby/bin:$PATH
export PATH=`gem environment gemdir`/bin:$PATH
eval "$(rbenv init -)"
fi
Don't want Homebrew to update your version? Then:
brew pin ruby
You can use the steps mentioned in How to install Ruby in a macOS for local development.
It worked great for me on macOS v13.3.1 (Ventura) (a) (22E772610a).
-
What is "22E772610a"? Some kind of version number (building number)? A Mac model number? Something else? Nov 21 at 18:01
-
The simplest way is definitely to enter the following command in the terminal:
sudo gem update --system
You can add the flag --no-document
if you do not want to download the documentation. Here is sample output after running the command:
sudo gem update --system
Password:
Updating rubygems-update
Fetching: rubygems-update-2.6.8.gem (100%)
Successfully installed rubygems-update-2.6.8
Parsing documentation for rubygems-update-2.6.8
Installing ri documentation for rubygems-update-2.6.8
Installing darkfish documentation for rubygems-update-2.6.8
Installing RubyGems 2.6.8
RubyGems 2.6.8 installed
Parsing documentation for rubygems-2.6.8
Installing ri documentation for rubygems-2.6.8
------------------------------------------------------------------------------
RubyGems installed the following executables:
/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/gem
Ruby Interactive (ri) documentation was installed. ri is kind of like man
pages for ruby libraries. You may access it like this:
ri Classname
ri Classname.class_method
ri Classname#instance_method
-
4Isn't this the same as the answer above? I'm curious why the number of downvotes here versus upvotes there? Is it because of the duplicate answer, or is it because people did not realize soon enough, that the earlier solution was also just for rubygems, not Ruby? Aug 14, 2017 at 19:27
brew link --overwrite --force ruby
-
7Please don't post code-only answers. The main audience, future readers, will be grateful to see explained why this answers the question instead of having to infer it from the code. Also, since this is an old, well answered question, please explain how it complements all other answers. Dec 18, 2022 at 19:56
which rvm
orwhich rbenv
in your command linebrew install ruby
is enough. check here