Getting Started
Created by Charly.palencia
Edited by Ingrid.Guerrero

Clean your Environment

We need to create a environment free of any issues did by before user on your computer. These are some step to create a clean user for mac machine:

  1. Turn On your mac and press command + s
  2. Run that code in your console:
 $ mount -uw /
 $ rm /var/db/.AppleSetupDone
 $ shutdown -h nowrm /var/db/.AppleSetupDone
 $ shutdown -h now

Note Complete video here

Create the environment

Install the Rails installer

This is a package to install the main environment tools. it include Ruby, Git, Rails, Sql, RVM, GCC and other ones
download the Mac OSX Kit Rails Installer :)

Install or update Xcode

Mac installation requires to update your system and install xcode current version dependent of your OSX version.Installation link
Search xcode of yours OSX Version


Once the .dmg has finished, open it and install.

Install Homebrew Installation link
Once the installation is successfull, verify on command prompt with

brew doctor

Note: If at the time of installation of RVM requirements asks for XCODE is required install it, but If not just need the GCC package.

Test your installation

 >> $ rvm version

If you have some problem or error different to xcode installation. please check here


Ruby is A dynamic, open source programming language with a focus on simplicity and productivity. It has an elegant syntax that is natural to read and easy to write. [1]


We gonna install our ruby version with rvm command

  $ rvm install 1.9.3

Note We can install different ruby versions over rvm environment. That is gonna be a helpful tool if you are going to work with new or old projects. You can find all the information about ruby rvm installation here

Switch ruby versions

Just have to type on the console

  $ rvm use x.x.x

When it show the ruby list, the current version used has a row ( => ) over the left side. Example:

rvm list
=> ruby-1.9.2-p290 [ x86_64 ]

Where can I start?

Ruby home page:
Code School Ruby course:
Ruby Monk:
Nice Tuto:


Gems are packages that contain information's package along with the files to install. One of the most used gem respository is rubygems [4].


gem are installed normally over the console:

  $ gem install  GEM_NAME

You probably gonna use the bundler gem [2] to install your gems in your application. if this case, you would install your gem writing them in your gemfile
  #rubygem file
gem "nokogiri"
gem "rails", "3.0.0.beta3"
gem "rack",  ">=1.0"
gem "thin",  "~>1.1"

and install them with:
  $ bundle install

What's the best gem for a specific functionality ?

You can find many information about gem around the web, but a great pleace for looking for is ruby toolbox[5].
The Ruby Toolbox is a comprehensive catalog of Ruby and Rails plug-ins, gems, tools and resources for Ruby developers. they are ranking about their amount of download over github page


RVM gives you compartmentalized independent ruby setups. This means that ruby, gems and irb are all separate and self-contained - from the system, and from each other.
The separate gems list to each project is called gemset.


You can create your gemset:

  $ rvm gemset create GEMSETNAME

Set a gemset

On your root directory create a file called .rvmrc and put your default configuration in it.:


  $  rvm 1.9.2-head@testing

you can select a default ruby version too:
  $  rvm --default 1.9.2-head@testing

How to know my current gemset list

Your current gemset appear with a row (=>) in the right name

  $ rvm gemset list
=> test1

Rails (Ruby on Rails)

Ruby on Rails or rails an open source full-stack web application framework for the Ruby programming language.[3]


  $ gem install "rails"

Where can i start?

Rails Screencast Page: railscasts
Code School Rails Course: Rails for zombies
Rails Guide: Rails for zombies

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License