Tutorial

How To Install Ruby on Rails with rbenv on Ubuntu 18.04

Published on July 13, 2018
English
How To Install Ruby on Rails with rbenv on Ubuntu 18.04
Not using Ubuntu 18.04?Choose a different version or distribution.
Ubuntu 18.04

Introduction

Ruby on Rails is one of the most popular application stacks for developers looking to create sites and web apps. The Ruby programming language, combined with the Rails development framework, makes app development simple.

You can easily install Ruby and Rails with the command-line tool rbenv. Using rbenv will provide you with a solid environment for developing your Ruby on Rails applications as it will let you easily switch Ruby versions, keeping your entire team on the same version.

rbenv provides support for specifying application-specific versions of Ruby, lets you change the global Ruby for each user, and allows you to use an environment variable to override the Ruby version.

This tutorial will take you through the Ruby and Rails installation process via rbenv.

Prerequisites

To follow this tutorial, you need:

Step 1 – Install rbenv and Dependencies

Ruby relies on several packages which you can install through your package manager. Once those are installed, you can install rbenv and use it to install Ruby,

First, update your package list:

  1. sudo apt update

Next, install the dependencies required to install Ruby:

  1. sudo apt install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm5 libgdbm-dev

Once the dependencies download, you can install rbenv itself. Clone the rbenv repository from GitHub into the directory ~/.rbenv:

  1. git clone https://github.com/rbenv/rbenv.git ~/.rbenv

Next, add ~/.rbenv/bin to your $PATH so that you can use the rbenv command line utility. Do this by altering your ~/.bashrc file so that it affects future login sessions:

  1. echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc

Then add the command eval "$(rbenv init -)" to your ~/.bashrc file so rbenv loads automatically:

  1. echo 'eval "$(rbenv init -)"' >> ~/.bashrc

Next, apply the changes you made to your ~/.bashrc file to your current shell session:

  1. source ~/.bashrc

Verify that rbenv is set up properly by using the type command, which will display more information about the rbenv command:

  1. type rbenv

Your terminal window will display the following:

Output
rbenv is a function rbenv () { local command; command="${1:-}"; if [ "$#" -gt 0 ]; then shift; fi; case "$command" in rehash | shell) eval "$(rbenv "sh-$command" "$@")" ;; *) command rbenv "$command" "$@" ;; esac }

Next, install the [ruby-build] (https://github.com/rbenv/ruby-build), plugin. This plugin adds therbenv install command, which simplifies the installation process for new versions of Ruby:

  1. git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

At this point, you have both rbenv and ruby-build installed. Let’s install Ruby next.

Step 2 – Installing Ruby with ruby-build

With the ruby-build plugin now installed, you can install versions of Ruby y may need through a simple command. First, let’s list all the available versions of Ruby:

  1. rbenv install -l

The output of that command should be a long list of versions that you can choose to install.

Let’s install Ruby 2.5.1:

  1. rbenv install 2.5.1

Installing Ruby can be a lengthy process, so be prepared for the installation to take some time to complete.

Once it’s done installing, set it as our default version of Ruby with the global sub-command:

  1. rbenv global 2.5.1

Verify that Ruby was properly installed by checking its version number:

  1. ruby -v

If you installed version 2.5.1 of Ruby, your output to the above command should look something like this:

Output
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]

To install and use a different version of Ruby, run the rbenv commands with a different version number, as in rbenv install 2.3.0 and rbenv global 2.3.0.

You now have at least one version of Ruby installed and have set your default Ruby version. Next, we will set up gems and Rails.

Step 3 – Working with Gems

Gems are the way Ruby libraries are distributed. You use the gem command to manage these gems. We’ll use this command to install Rails.

When you install a gem, the installation process generates local documentation. This can add a significant amount of time to each gem’s installation process, so turn off local documentation generation by creating a file called ~/.gemrc which contains a configuration setting to turn off this feature:

  1. echo "gem: --no-document" > ~/.gemrc

Bundler is a tool that manages gem dependencies for projects. Install the Bundler gem next. as Rails depends on it.

  1. gem install bundler

You’ll see output like this:

Output
Fetching: bundler-1.16.2.gem (100%) Successfully installed bundler-1.16.2 1 gem installed

You can use the gem env command (the subcommand env is short for environment) to learn more about the environment and configuration of gems. You can see where gems are being installed by using the home argument, like this:

  1. gem env home

You’ll see output similar to this:

/home/sammy/.rbenv/versions/2.5.1/lib/ruby/gems/2.5.0

Once you have gems set up, you can install Rails.

Step 4 – Installing Rails

To install Rails, use the gem install command along with the -v flag to specify the version. For this tutorial, we will use version 5.2.0:

  1. gem install rails -v 5.2.0

The gem command installs the gem you specify, as well as every dependency. Rails is a complex web development framework and has many dependencies, so the process will take some time to complete. Eventually you’ll see a message stating that Rails is installed, along with its dependencies:

Output
... Successfully installed rails-5.2.0 38 gems installed

Note: If you would like to install a different version of Rails, you can list the valid versions of Rails by doing a search, which will output a long list of possible versions. We can then install a specific version, such as 4.2.7:

  1. gem search '^rails$' --all
  2. gem install rails -v 4.2.7

If you would like to install the latest version of Rails, run the command without a version specified:

  1. gem install rails

rbenv works by creating a directory of shims, which point to the files used by the Ruby version that’s currently enabled. Through the rehash sub-command, rbenv maintains shims in that directory to match every Ruby command across every installed version of Ruby on your server. Whenever you install a new version of Ruby or a gem that provides commands, like Rails does, you should run:

  1. rbenv rehash

Verify that Rails has been installed properly by printing its version, with this command:

  1. rails -v

If it installed properly, you will see the version of Rails that was installed:

Output
Rails 5.2.0

At this point, you can begin testing your Ruby on Rails installation and start to develop web applications. Let’s look at keeping rbenv up to date.

Step 5 – Updating rbenv

Since you installed rbenv manually using Git, you can upgrade your installation to the most recent version at any time by using the git pull command in the ~/.rbenv directory:

  1. cd ~/.rbenv
  2. git pull

This will ensure that we are using the most up-to-date version of rbenv available.

Step 6 – Uninstalling Ruby versions

As you download additional versions of Ruby, you may accumulate more versions than you would like in your ~/.rbenv/versions directory. Use the ruby-build plugin ‘s’ uninstall subcommand to remove these previous versions.

For example, typing this will uninstall Ruby version 2.1.3:

  1. rbenv uninstall 2.1.3

With the rbenv uninstall command you can clean up old versions of Ruby so that you do not have more installed than you are currently using.

Step 7 – Uninstalling rbenv

If you’ve decided you no longer want to use rbenv, you can remove it from your system.

To do this, first open your ~/.bashrc file in your editor:

  1. nano ~/.bashrc

Find and remove the following two lines from the file:

~/.bashrc
...
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

Save the file and exit the editor.

Then remove rbenv and all installed Ruby versions with this command:

 rm -rf `rbenv root`

Log out and back in to apply the changes to your shell.

Conclusion

In this tutorial you installed rbenv and Ruby on Rails. From here, you can learn more about making those environments more robust.

Explore how to use Ruby on Rails with PostgreSQL or MySQL rather than its default sqlite3 database, which provide more scalability, centralization, and stability for your applications. As your needs grow, you can also learn how to scale Ruby on Rails applications across multiple servers.

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about us


About the authors


Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
4 Comments


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Nice tutorial. I come from rvm the last time I touched Ruby. This feels a bit simpler, like there’s less magic going on behind the scenes.

Thank you for a great tutorial! The commands: git clone https://github.com/rbenv/rbenv.git ~/.rbenv and git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build were giving me an error fatal: unable to access ‘https://github.com/rbenv/rbenv.git/’: gnutls_handshake() failed: Error in the push function, I realized that I had to use http instead of https , is there a reason why this is happening?

Excellent tutorial!

Two minor corrections:

“Then add the command ~/.rbenv/bin/rbenv init to your ~/.basrc file so rbenv loads automatically:”

  1. .basrc should be .bashrc
  2. The command added to .bashrc is actually eval "$(rbenv init -)", NOT ~/.rbenv/bin/rbenv init

I think running the following command works better:

  1. modify the PATH variable and add export PATH=$HOME/.rbenv/bin:$PATH
  2. run installer:

curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-installer | bash

or with wget:

wget -q https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-installer -O- | bash

  1. add rbenv init to shell startup too:

eval “$(rbenv init -)”

Source for this info: https://github.com/rbenv/rbenv-installer#rbenv-installer

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more
DigitalOcean Cloud Control Panel