Getting Started With Ruby On Rails

Generally there are 3 installations: OSX, Windows and Linux, and the latter is the most easy one.


Go to, and download the package containing gems (windows installer).

Install the package.

Update the gem system via:

gem update --system

Update installed gems via:

gem update

When this is done install the relevant gems. I would suggest the following as a minimum:
*rails (for the framework)
    Please note, that rails 2.02 is the newest version, you can install an older version via

gem install v1.2.6 rails

*mysql (for database assess)
*mongrel (webserver better when webrick)

When asked for the version you want to use, choose the newst version, that has win32 in the option.


OSX 10.4 and 10.5

Go to and download the correct version of the file (tiger/leopard).

Read through the installation guide:

Quick guide:
Install the correct xcode for your system.
Install the macports program (this can take a little while)
When done, do:

sudo port install ruby
sudo port install rb-gems (enabling gems under ruby)
sudo gem install rails (framework)
sudo port install rb-mysql (mysql for use under RoR)
sudo gem install mongrel (webserver)
sudo port install subversion (for easy install for remote plugins)


Linux (Ubuntu like / Debian based)

sudo apt-get update && sudo apt-get upgrade (getting newst list, and updateing software before continuing).
sudo apt-get install ruby subversion mysql libmysql-ruby1.8
sudo gem install rails
sudo gem install mongrel

And you should be set to go.

IDE for use with RoR:
Textmate (OSX), has very poor subversion integration, but good RoR integration
    Not free
Eclipse (good integration, via plugins) download plugins via Aptana website, for RoR support.

Aptana (good integration via plugins)
    complete IDE, eclipse based. Free
IDEA (good integration via plugins)
    Complete IDE suite, with great integration of subversion, mysql and even jira for bugtracking.
    Professional, but expensive.

Remeber to point your IDE to where your RoR / rails is installed for best integration:
Windows most often: c:\ruby\bin
OSX: /opt/local/
Linux: /usr/bin/ruby




sudo gem update --system

Which introduced this error:

/usr/bin/gem:23: uninitialized constant Gem::GemRunner(NameError)

whenever I tried to run rubygems. On the rails forum, I found a fix for it!. Simply add the line to the file /usr/bin/gem (may be different on a mac):

require 'rubygems/gem_runner'


require 'rubygems'


This error when installing gems:

extconf.rb:1:in `require’: no such file to load—mkmf (LoadError)

from extconf.rb:1.


sudo apt-get install ruby1.8-dev


Share this page:

1 Comment(s)