Install Ruby on Rails on Ubuntu 10.10

Ruby on Rails LogoIn my post, Install CakePHP on Ubuntu 10.10, we took an in-depth view into installing CakePHP on Ubuntu 10.10.  Since then, I’ve received some emails that collectively said:

Hey, why no love for Ruby on Rails?

When I posted the CakePHP tutorial it was not in any way an attempt to slight Ruby on Rails.  In fact, I like the structural organization and community spirit spurred by Ruby on Rails just as much as the next person, and I’m not the sort of person that wastes too much time engaging in debates over development frameworks.  They way I see it, if a framework is good it will thrive, and if it isn’t good it won’t. Survival of the fittest is as powerful in the world of technology as it is in nature and capitalism.  That said, both PHP and Ruby programmers have the luxury of choosing their own rapid development framework whether it be CakePHP or Ruby on Rails, respectively, so both communities are currently thriving. That makes me happy too, because it encourages healthy competition, and this competition only leads to bigger and better advances for the web as a whole.

For those of you interested in developing web applications using Ruby, this week we’ll look at how to install Ruby on Rails, the framework that inspired the creation of CakePHP. It’s not a stretch to say that if Ruby on Rails didn’t exist, with its RESTful design practices and file structure, CakePHP may not have ever come into being.  From a structural standpoint, CakePHP borrows a lot from Ruby on Rails, so there is definitely some truth to this notion.

Unlike CakePHP, Ruby on Rails (which we’ll herein refer to as simply, “Rails”) does not require Apache (at least for development).  It actually installs with a small Ruby-based web server called WEBrick that runs on port 3000.  WEBrick isn’t very well documented, and it’s not the greatest web server — it’s not even intended for a production environment, but WEBrick is small and portable, which somehow makes it nice for developing and learning Rails.

This install guide begins immediately after a base install of Ubuntu has been completed.  It takes us through installing the fundamentals, and ends with a working install of Rails, ready for development work.

Phase I: The Basics

One of the coolest things about installing Rails is that unlike CakePHP, Rails can be installed with relatively few prerequisites.  In fact, we don’t even need Apache or MySQL.  Also using a package manager like apt-get to download software in Ubuntu typically makes the most sense, when setting up Rails, I cannot think of a worse option.  apt-get pulls software down from the Ubuntu repositories, and these repositories simply do not have current versions of the software that comprises a solid Rails development install.  That’s not to say we won’t use apt-get, because we will, but only to download and install some supporting stuff prior to getting into the heart of the actual Rails install.

The supporting packages are:

  • Git: we’ll be using git as a foundation for rvm
  • curl: this will be used to download rvm
  • build-essential: a set of packages used for compiling source code
  • OpenSSH Server: for convenient remote shell access

To install the aforementioned packages, all we need to do is access our terminal and type:

regularuser@smalleycreative:~$ sudo apt-get install git curl build-essential vim openssh-server

Phase II: Get rvm

Once the base packages finish installing, we can being the heart of our Rails install by installing rvm, the Ruby Version Manager. This is done by typing:

regularuser@smalleycreative:~$ bash < <( curl )

Notice that didn’t use sudo at all in this command. rvm installs to our home directory, which we have full access to, so no root privileges are required! This is a plus on systems with multiple users. Every user on a server can install rvm to their own home directory, and each user can have their own custom development setup with whatever version of Ruby they wish without interfering with any other users.
Once rvm is downloaded, we’re going to need to add a line to our .bashrc file. The .bashrc file is a file that loads every time we run bash (our default terminal shell in Ubuntu). Each user gets their own .bashrc file in their own home directory. Inside this file, we can set up customizations to our environment that run every time bash is started. There are probably hundreds of cool modifications you can make to your .bashrc file, but for this situation, we need to add a line to it telling it that when we open bash, we want rvm to be available to us. We can do this without ever opening our text editor by typing:

regularuser@smalleycreative:~$ echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"' >> ~/.bashrc

This command echos everything between the single quotes to (>>) our .bashrc file.
After modifying our .bashrc, we need to update the bash session we’re currently working in so that it takes these new settings and uses them. We can very easily reload our .bashrc file by typing:

regularuser@smalleycreative:~$. ~/.bashrc

Now if that generated an error or didn’t work, it could be because you forgot the first . (period) character. This . tells Linux that we want to run a script. What script? The .bashrc script! Since we added lines to the end of this script, it will now include rvm, and this is precisely what we want.

Phase III: Dependencies, Rails, and Ruby… Almost Done

Now that rvm is installed we can finish up tying up some loose ends before we move forward with Rails development on this machine. There are only three more steps until we’re ready to develop in Rails. We need to:

  • install a few more required packages that Rails depends upon
  • install Rails
  • choose and install a version of Ruby

Excited? You should be. Rails is an absolute joy to work with if you put the time in to learn about it. To find out what packages still need to be installed type:

regularuser@smalleycreative:~$ rvm notes

This command just prints out the release notes for rvm, but what’s really nice is that these notes are dynamic. Since we compiled rvm for our own server, the notes include information about our platform as well as a full list of recommended packages that should be installed. After issuing this command, you’ll likely see something like this:

Notes for Linux ( DISTRIB_ID=Ubuntu

NOTE: 'ruby' represents Matz's Ruby Interpreter (MRI) (1.8.X, 1.9.X)
             This is the *original* / standard Ruby Language Interpreter
      'ree'  represents Ruby Enterprise Edition
      'rbx'  represents Rubinius

bash >= 3.2 is required
curl is required
git is required (>= 1.7 recommended)
patch is required (for ree and some ruby-head's).

If you wish to install rbx and/or Ruby 1.9 head (MRI) (eg. 1.9.2-head),
then you must install and use rvm 1.8.7 first.

If you wish to have the 'pretty colors' again,
  set 'export rvm_pretty_print_flag=1' in ~/.rvmrc.

# For RVM
  rvm: bash curl git

# For Ruby (MRI & ree)  you should install the following OS dependencies:
  ruby: aptitude install build-essential bison openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-0 libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev

# For JRuby (if you wish to use it) you will need:
  jruby: aptitude install curl g++ openjdk-6-jre-headless

# In addition to ruby: dependencies,
  ruby-head: subversion

# For IronRuby (if you wish to use it) you will need:
  ironruby: aptitude install curl mono-2.0-devel

Pay particular attention to the section I bolded above. It reads:

# For Ruby (MRI & ree)  you should install the following OS dependencies:
  ruby: aptitude install build-essential bison openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-0 libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev

rvm notes couldn’t make things easier. It has listed out all of the packages that should now be installed for Ruby to work optimally. Though it hints at using aptitude to install these packages, I tend to use apt-get for installing packages on my server. For the sake of consistency, we’ll continue to use apt-get. To install these packages using apt-get, simply type:

regularuser@smalleycreative:~$ sudo apt-get install build-essential bison openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-0 libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev

Once these packages finish installing, we can install Ruby by typing:

regularuser@smalleycreative:~$ rvm install 1.9.2

Once Ruby installs we tell rvm that we want to use the version we installed (1.9.2) by typing:

regularuser@smalleycreative:~$ rvm use 1.9.2

As you can see, rvm makes it very simple to install and switch between different versions of Ruby rather quickly. For example, if we wanted to switch to an earlier version of Ruby, say Ruby 1.8.7, we could do this by typing:

regularuser@smalleycreative:~$ rvm install 1.8.7

And select it by typing:

regularuser@smalleycreative:~$ rvm use 1.8.7

Also, if you install a version of Ruby you don’t need to reinstall it the next time you want to use it. You can just issue the use command to rvm, and rvm will switch to the version of Ruby you specify. For a complete list of available versions of Ruby in rvm, type:

regularuser@smalleycreative:~$ rvm list known

If you’re ever unclear about what version of Ruby you’re currently running your code on, just type:

regularuser@smalleycreative:~$ ruby -v

When I ran this on my server it returned:

ruby 1.9.2p136 (2010-12-25 revision 30365) [i686-linux]

Since we will typically want to default to the most current installed version of Ruby, we should type:

regularuser@smalleycreative:~$ rvm --default use 1.9.2

This sets us up so that every time we log into our server we are going to be set to use Ruby 1.9.2. As with everything else in this tutorial, because rvm is installed in our home directory, this won’t affect any other users on our server — we can change the version of Ruby we use whenever we want without fear of breaking a friend’s development environment.
We’re now left with one final step, and that is to install Rails. After all, this isn’t a tutorial on how to install Ruby, this is a tutorial on how to install Ruby on Rails!
Now that we’ve got a solid foundation with rvm, it’s very simple to install Rails. Just type:

regularuser@smalleycreative:~$ gem install rails

After a few seconds, Rails will be installed.

Phase IV: Get Coding!

If you’re completely unfamiliar with Rails I highly recommend heading over to to begin your studies. You can read the entire Rails Tutorial book online. The author, Michael Hartl, has done an amazing job of explaining Rails fundamentals, and I highly recommend this resource as a great first step in your Rails education. If you like the book, do Michael a favor and purchase it from him. He’s done a great job — you’d be hard pressed to find a better introduction to Rails and Ruby in general. Happy coding!

Michael is the creator and main author of the Smalley Creative Blog. He is a guy who enjoys technology (particularly open source), educating people about technology, and working with people who enjoy technology as much as he does. Follow him on Twitter @michaeljsmalley.

Leave a reply:

Your email address will not be published.

Site Footer