Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
A Bash script to install Ruby 3.0 on the Raspberry Pi (Raspbian)
# --------------------------------------------------------------------------------------------
# Installs Ruby 3.0 using rbenv/ruby-build on the Raspberry Pi (Raspbian)
# Run from the web:
# bash <(curl -s
# --------------------------------------------------------------------------------------------
# Welcome message
echo -e "
This will install Ruby 3.0 using rbenv/ruby-build.
It will take about 2 hours to compile on the original Raspberry Pi,
35 minutes on the second generation, and 16 minutes on the third.\n"
# Prompt to continue
read -p " Continue? (y/n) " ans
if [[ $ans != "y" ]]; then
echo -e "\nQuitting...\n"
# Time the install process
# Check out rbenv into ~/.rbenv
git clone ~/.rbenv
# Add ~/.rbenv/bin to $PATH, enable shims and autocompletion
read -d '' String <<"EOF"
# rbenv
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
# Save to ~/.bashrc
echo -e "\n${String}" >> ~/.bashrc
# Enable rbenv for current shell
eval "${String}"
# Install ruby-build as an rbenv plugin, adds `rbenv install` command
git clone ~/.rbenv/plugins/ruby-build
# Install dependencies
# See:
sudo apt update
sudo apt install -y autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm3 libgdbm-dev
# Install Ruby 3.0, don't generate RDoc to save lots of time
CONFIGURE_OPTS="--disable-install-doc --enable-shared" rbenv install 3.0.0 --verbose
# Set Ruby 3.0 as the global default
rbenv global 3.0.0
# Don't install docs for gems (saves lots of time)
echo "gem: --no-document" > ~/.gemrc
# Reminder to reload the shell
echo -e "\nReload the current shell to get access to rbenv using:"
echo " source ~/.bashrc"
# Print the time elapsed
echo -e "\nFinished in $(($ELAPSED_TIME/60/60)) hr, $(($ELAPSED_TIME/60%60)) min, and $(($ELAPSED_TIME%60)) sec\n"
Copy link

andrewhavens commented Jan 7, 2014



Copy link

MtnBiker commented Nov 7, 2014

Thanks for this. Wish I'd seen it earlier as I was having a problem installing. I think my install is taking more than two hours. But can watch the log to make sure it's still progressing.


Copy link

ceboxsell commented Feb 11, 2015

Pi 2, 22 min 14 sec


Copy link

elsurudo commented Mar 1, 2015

I've tried this multiple times, and it gets quite far in. However, at the "Parsing sources", stage, CPU usage goes through the roof, and the RPi eventually just reboots itself, and the installation doesn't finish.

Last few lines of log:

3% [33/967]  ChangeLog
  3% [34/967]  NEWS
  3% [35/967]  README.EXT
  3% [36/967]  README.EXT.ja
  3% [37/967]  addr2line.c
  3% [38/967]  array.c
  4% [39/967]  bignum.c
  4% [40/967]  class.c
  4% [41/967]  compar.c
  4% [42/967]  compile.c
  4% [43/967]  complex.c
  4% [44/967]  cont.c
  4% [45/967]  debug.c
  4% [46/967]  dir.c
  4% [47/967]  dln.c
  4% [48/967]  dln_find.c
  5% [49/967]  dmydln.c
  5% [50/967]  dmyenc.c
  5% [51/967]  dmyext.c
  5% [52/967]  doc/ChangeLog-1.8.0
  5% [53/967]  doc/ChangeLog-1.9.3
  5% [54/967]  doc/ChangeLog-2.0.0

Any ideas? I've tried three times now, and it always stops at the exact same point.


Copy link

jackregnart commented Mar 12, 2015

--disable-install-doc This seems to be a good trick... I'm at 306 minutes so far. Yesterday's attempt with a really bad SD card was at 580+ minutes before I went to bed and it failed sometime overnight... A good SD card is key too it seems - using my GoPro's class 10 now.

I think I am going to be getting into the habit of doing this now so ruby doesn't build docs if it doesn't need to - rbenv/rbenv-vars#18 (comment)


Copy link

the911s commented Apr 19, 2015



Copy link

luketlancaster commented Apr 28, 2015

👍 1 hr, 55 min, 29 seconds. Thanks for the gist, worked like a dream


Copy link

facastagnini commented Apr 28, 2015

Why to take all that work when you can simply do:

  cd /usr/src/
  tar -xvzf ruby-2.2.2.tar.gz
  cd ruby-2.2.2
  ./configure --enable-shared --disable-install-doc --disable-install-rdoc --disable-install-capi
  make install



Copy link

Donavan commented Jun 27, 2015

@blacktm you should really add "--enable-shared" to the configure opts.
@facastagnini what you posted doesn't install of the dependencies not rbenv


Copy link

delneet commented Oct 30, 2015



Copy link

causztic commented Jan 30, 2016

thanks for this!


Copy link

LimeBlast commented Feb 5, 2016

This is excellent, thank you. It took about 35 minutes on my rPi 2.

It didn't load rbenv for the current shell, but re-launching terminal fixed that right up.


Copy link

daz commented Mar 31, 2016

16 minutes on RPI 3


Copy link

medright commented Aug 4, 2016

Thanks! Just got done running on my second pi, 19min 9sec on this one, 33min on the other, this was very smooth.


Copy link

davecozz commented Sep 9, 2016

Great script, thanks. One suggestion: make sure git is installed before running git commands.
sudo apt-get update && sudo apt-get install -y git-core

Other than that it worked great on my Rpi 3
Finished in 0 hr, 15 min, and 56 sec


Copy link

MitchDresdner commented Oct 13, 2016

Worked great for getting Ruby running on my Pi3

But ...

I had to come here to get rails working:


Copy link

ghost commented Nov 20, 2016

"Oh no! Something has gone wrong."

My Output:

pi@raspberrypi:~ $ uname -a
Linux raspberrypi 4.4.32-v7+ #924 SMP Tue Nov 15 18:11:28 GMT 2016 armv7l GNU/Linux

pi@raspberrypi:~ $ sudo sh
Building dependency tree
Reading state information... Done
All packages are up to date.
Reading package lists... Done
Building dependency tree
Reading state information... Done

0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded. 53: rbenv: not found 56: rbenv: not found
Reload the current shell to get access to rbenv using:
source ~/.bashrc 66: arithmetic expression: expecting primary: " - "


Copy link

ghost commented Nov 20, 2016


pi@raspberrypi: sudo apt-get install ruby-full

pi@raspberrypi:~ $ ruby -v
ruby 2.1.5p273 (2014-11-13) [arm-linux-gnueabihf]
Source: Openshift


Copy link

ministryman commented Apr 4, 2017

@Robertthcan: It's too late, but I ran into the same problem (after trying to install ruby and upgrading it to 2.4, and borking my system)

sudo apt-get install rbenv curl

I added curl just in case. The error output showed that the script could not find rbenv. I assumed it wasn't installed for some reason, so I did it.

Then Re run the script.


Copy link

ghost commented Jun 10, 2017

took 44 minutes on a RPi 3B but helped a lot!! thanks


Copy link

racecarparts commented Aug 5, 2017

Great gist! Thanks!
Raspberry Pi Zero W:
Finished in 1 hr, 26 min, and 24 sec


Copy link

roosdorp commented Aug 25, 2017

Thanks, very easy to install the latest version of Ruby onto my Raspberry Pi. Took 2 hr, 21 min, and 42 sec on an Model B+ with Raspbian Stretch.


Copy link

pjha1994 commented Dec 14, 2017

My version of ruby is still 2.1:

pi@raspberrypi:~ $ ruby -v
ruby 2.4.2p198 (2017-09-14 revision 59899) [armv7l-linux-eabihf]

It installed successfully, without any errors. I had ruby installed earlier via apt-get. How do I get access tot he new version to work? Do I need to add some path?


Copy link

DeafScribe commented Dec 31, 2017

Pi3, 35 minutes and 28 seconds. My setup reported version 2.1 immediately after the install, but reports 2.5.0 after a reboot. Thank you, sir!


Copy link

DirtyScience commented May 11, 2018

Pi3, Raspbian Lite (Stretch), 14min/11sec. No reported errors. Nice job!


Copy link

yjchieng commented Jun 4, 2018

pi3b+, Raspbian, Ruby 2.4.4, 17minutes.


Copy link

erikyuzwa commented Aug 5, 2018

This gist is unreal. Amazing work, thanks a lot @blacktm

Pi3 on Jesse (I think - I'm a n00b). No errors. This just worked. Roughly 30 minutes (didn't really time it), but I wouldn't care if it took 4 hours.


Copy link

alxprogrmz commented Feb 18, 2019

I don't care how long it takes as long as it worked. I bet he took his precious time writing this wonderful script. Thank you so much for your contribution. I wish I could write a script like you.


Copy link

johhnry commented Jun 4, 2019

I have the following warning messages :

  • 19: [[: not found
  • The installation stopped and it says :
Installed ruby-2.6.3 to /home/pi/.rbenv/versions/2.6.3

Reload the current shell to get access to rbenv using:
  source ~/.bashrc 66: arithmetic expression: expecting primary: " - "`


Copy link

osullii commented Jul 6, 2019

Thanks a million @blacktm for creating this bash script. Ruby 2.6 downloaded for me in 22 minutes. No stress. :-)

Wonderful script. Thank you again for posting.


Copy link

donrestarone commented Mar 17, 2020

Hey @blacktm! First of all amazing work. This is a solid script. But I'm having an issue getting it to work on a Raspberry Pi 4 running Raspbian Buster 2020-2-13 version. Everything gets installed correctly, but when I try to invoke Rails s (or sidekiq or any gem) I get a massive error 1000+ lines long that ends with "You may have encountered a bug in the Ruby interpreter or extension libraries.
Bug reports are welcome."
Any ideas?


Copy link

FrangaL commented Nov 30, 2021

Calculate total time compilation.

total_time() {
  local T=$1
  local H=$((T/60/60%24))
  local M=$((T/60%60))
  local S=$((T%60))
  printf '\nFinished in '
  [[ $H -gt 0 ]] && printf '%d hours ' $H
  [[ $M -gt 0 ]] && printf '%d minutes ' $M
  [[ $D -gt 0 || $H -gt 0 || $M -gt 0 ]] && printf 'and '
  printf '%d seconds\n' $S

total_time $SECONDS


Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment