Other Pages

Expand All

OS X RVM

Step 1: Open Terminal

Look for Terminal.app inside Applications -> Utilities.

Add it to your dock; you'll be using it a lot. (To add it to the dock, click and hold the dock icon once Terminal is open. Select options -> keep in dock.)

Arrange your windows so that Terminal and your web browser are next to each other. You will want to read from your browser and type into your terminal at the same time.

Step 2: Install A Compiler (XCode or GCC)

Go on to Install Xcode

Step 3: Install Homebrew

Type this in the terminal:
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

You may have to press 'ENTER' when prompted and type in your password.

If that doesn't work, visit https://github.com/Homebrew/homebrew/wiki/installation and follow the instructions there.

Verify

Type this in the terminal:
brew -v
Approximate expected result:
Homebrew 0.9.5
The greyed-out text may differ and is not important.

Step 4: Install Git

Next we'll install Git, the most popular version control system in the Ruby world:

Type this in the terminal:
git --version
Approximate expected result:
git version 1.x.x
The greyed-out text may differ and is not important.

If you see that output, you have Git. Move on to the next step.

Otherwise, type this in the terminal:
brew install git

Verify

Type this in the terminal:
git --version
Approximate expected result:
git version 1.x.x
The greyed-out text may differ and is not important.

Step 5: Install RVM, the Ruby Version Manager

RVM stands for Ruby Version Manager and is the easiest way to install and manage Ruby. The official RVM install instructions are available here, but this should work for you:

Step 5.1: Install RVM

Type this in the terminal:
curl -L get.rvm.io | bash -s stable

This will do some stuff and print a long message which you can ignore.

Step 5.2: Configure your shell

Every time you open a new terminal window, rvm will be active inside it. Close your terminal window and open a new one.

Verify

Type this in the terminal:
type rvm | head -1
Expected result:
rvm is a function
Type this in the terminal:
rvm -v
Approximate expected result:
rvm 1.x.x (stable) by Wayne E. Seguin (wayneeseguin@gmail.com), Michal Papis <mpapis@gmail.com> [https://rvm.beginrescueend.com/]
The greyed-out text may differ and is not important.

Step 6: Configure RVM to use Homebrew

Type this in the terminal:
rvm autolibs homebrew

Step 7: Install Ruby

Type this in the terminal:
rvm install 2.0.0

This downloads and compiles Ruby, which takes a while.

Type this in the terminal:
rvm use 2.0.0
rvm --default use 2.0.0

Verify

Type this in the terminal:
ruby -v
Approximate expected result:
ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-darwin13.0.0]
The greyed-out text may differ and is not important.

Troubleshooting

If rvm install 2.0.0 says autoreconf was not found in the PATH

Mac OS
Type this in the terminal:
brew install automake
Ubuntu Linux
Type this in the terminal:
sudo apt-get install automake

Once that completes, retry rvm install 2.0.0

Step 8: Install Rails

Type this in the terminal:
gem install rails

Verify

Type this in the terminal:
rails -v
Approximate expected result:
Rails 4.0.x
The greyed-out text may differ and is not important.

Step 9: Install Sublime Text 2

We'll be using the Sublime Text 2 text editor during the workshop, though you are free to use a different editor if you prefer. It must be a plain-text editor, such as vi or TextMate.

Microsoft Word and other word processing programs, including TextEdit and Notepad, will not work.

When in doubt, use Sublime Text 2.

Step 9.1: Download Sublime Text 2

Download the Sublime Text 2 installer.

Step 9.2: Select "Open with DiskImageMounter" in the file save dialog

This should be the default.

It will open an installer with a Sublime Text 2 icon and a picture of your Applications folder. Something like this:

Step 9.3: Drag Sublime Text 2 into your Applications folder.

It will open an installer with a Sublime Text 2 icon and a picture of your Applications folder. Drag Sublime Text 2 into your Applications folder.

Step 9.4: Unmount the installer disk image

by dragging it from your desktop to the trash

Verify successful installation

Type this in the terminal:
git --version
Approximate expected result:
git version 1.x.x
The greyed-out text may differ and is not important.
Type this in the terminal:
which ruby
Approximate expected result:
/Users/alex/.rvm/rubies/ruby-2.0.0-p247/bin/ruby
The greyed-out text may differ and is not important.
Type this in the terminal:
which rails
Approximate expected result:
/Users/alex/.rvm/gems/ruby-2.0.0-p247/bin/rails
The greyed-out text may differ and is not important.

Next Step:

Go on to Configure Git