Install Ruby and Ruby on Rails on Your system

Sayan Bandyopadhyay
5 min readAug 10, 2019

--

This Blog is about how you can install Ruby and Ruby on Rails on Your Windows, Linux or Mac Operating system.

1. Installing Rails in Windows Operating System

Perhaps the easiest one, Go to http://railsinstaller.org/en and download the latest package for your Windows Operating System.

This package will contain everything and you will not have to install everything like Ruby compiler, Rails, Git etc separately.

2. Install Rails in Mac OS

We’re not going to mess with installing a fancy database, alternate testing frameworks, or anything like that; this is an easy, bare-bones installation that will let you try Rails and see if it’s right for you.

  • We’ll use Homebrew, a software package installer, to install some libraries that both Ruby and Rails rely on.
  • Then we’ll use “rvm”, the Ruby Version Manager, to install a new version of Ruby. Macs already come with a version of Ruby installed, but it’s usually a little out of date. rvm will install an up-to-date version alongside your existing version.
  • Lastly, we’ll use our newly-installed Ruby tools to install the Rails library itself.

First, you’ll need to open a terminal. If you haven’t done this before, visit your Applications folder in the Finder, then open the “Utilities” folder, and double-click the “Terminal” app. Once that’s done, you’ll be ready to follow along for the rest of these directions.

Homebrew

Installing Rails requires several software packages. And Homebrew, the package manager, can automatically download and install these packages for us. So let’s start by installing Homebrew.

Copy and paste this Ruby command into your terminal, then hit the Return key to run it:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

(Macs actually come with a version of Ruby pre-installed. It’s a bit outdated, but it’s recent enough to install Homebrew for us.)

When the install finishes, you’ll see the dollar sign prompt again. Now it’s time to install our first Homebrew package. For security reasons, we’re going to need an encryption tool named “gpg”, so let’s install that. In your terminal, run:

brew install gpg

Wait a bit, and when it returns to the command prompt, the gpg software will be installed.

Ruby Version Manager (rvm)

And now we’re ready to install rvm, the Ruby Version Manager. rvm will download, compile, and install new Ruby versions for us.

Copy and paste these two commands into your terminal:

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
\curl -sSL https://get.rvm.io | bash -s stable

(Yes, that is a backslash before the “curl” command. It’s there to avoid potential version conflicts.)

rvm is now installed, but it won’t be available until you open a new terminal window. So go ahead and open a new window from the menu. Then, try running the “rvm” command all by itself. If it outputs usage information, you’ll know it’s working.

Ruby

Now that rvm is installed, we can have it install a new Ruby version for us. Run this command from your terminal:

rvm install 2.3.1

When it returns to the system prompt, Ruby will be installed. But it may not be available in your terminal yet. To tell rvm to use the Ruby version you just installed, and to use this version by default in the future, run this command in your terminal:

rvm use 2.3.1 --default

Rails

Now it’s time to install Rails. Rails comes as a Ruby “gem”. A gem is a library, a collection of reusable code, that can be automatically downloaded and installed on your system, using the “gem” tool. In your command prompt, run:

gem install rails --version 5.0.0

The “gem” program will download and install that version of the Rails gem, along with all the other gems Rails depends on.

That’s it!

You should be ready to create your first Rails app!

3. Install Rails in Linux OS

First, open a terminal. If you haven’t done that before, you can click the button in the upper-left to search your computer, and type “terminal”. Click the “Terminal” application in the list of results. Once that’s done, you’ll be ready to follow along for the rest of these directions.

Ruby Version Manager (rvm)

We need to install rvm, the Ruby Version Manager. rvm will download, compile, and install new Ruby versions for us.

But to install rvm, we first need the “curl” program. We’ll install that via a package manager. In your terminal, run this command:

sudo apt-get install curl

You’ll need to provide your system password. When the installation is complete, you’ll be returned to your system prompt.

Now we’re ready to install rvm. Copy and paste these two commands into your terminal:

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
\curl -sSL https://get.rvm.io | bash -s stable

(Yes, that is a backslash before the “curl” command. It’s there to avoid potential version conflicts.)

rvm is now installed, but it won’t be available until you open a new terminal window. So go ahead and open a new window from the menu. Then, try running the “rvm” command all by itself. If it outputs usage information, you’ll know it’s working.

Ruby

Now that rvm is installed, we can have it install a new Ruby version for us. From your terminal, run:

rvm install 2.3.1

rvm may need to install some packages that Ruby depends on. If it asks, type your system password and press Enter to continue.

When it returns to the system prompt, Ruby will be installed. But it’s not available in your terminal yet. If you type ruby -v to look at your ruby version, you’ll probably either get a message saying Ruby is NOT installed, or you’ll get an older version of Ruby. To tell rvm to use the Ruby version you just installed, and to use that version by default in the future, run:

rvm use 2.3.1 --default

Setting your terminal for login shell

When you try to run the “rvm use” command, you may get an error: “RVM is not a function… You need to change your terminal emulator preferences to allow login shell.” If that happens, you’ll need to go to a search engine to figure out how to enable login shell for your terminal.

If you don’t know what terminal program you’re using, you can look in the About menu. Ubuntu comes with “Gnome Terminal” by default, so that’s what we used for this installation. So we’d type into a search engine: “gnome terminal login shell”.

Among the results, we found a page that said “you have to enable ‘Run Command as a login shell’ in the gnome-terminal ‘Profile Preferences’, reachable from the Edit menu.” So we followed the menus:

  • “Edit”
  • “Profile Preferences”
  • “Command” tab
  • Check “Run command as a login shell”
  • Click “Close”
  • Open another new terminal window so it takes effect

After that, we ran rvm use 2.3.1 --default again, and it worked.

Of course, these particular directions will only help you if you’re using Gnome Terminal. If you’re using a different program, try your own web search.

Rails

Now it’s time to install Rails. Rails comes as a Ruby “gem”. A gem is a library, a collection of reusable code, that can be automatically downloaded and installed on your system, using the “gem” tool. In your terminal, run:

gem install rails --version 5.0.0

The “gem” program will download and install that version of the Rails gem, along with all the other gems Rails depends on.

Node.js

There’s one last thing we need to take care of… Some libraries that Rails depends on require a JavaScript runtime to be installed. Let’s install Node.js so that those libraries work properly. In your terminal, use your package manager to install the nodejs package:

sudo apt-get install nodejs

You’ll be prompted for your system password again, and then Node.js will be installed.

That’s it!

You should be ready to create your first Rails app!

--

--

Sayan Bandyopadhyay

Full-time Developer, part-time Blogger. Sarcasm is my love language and procrastination is my superpower.