Rails is een Ruby web framework en vereist dan ook een Ruby installatie. Omdat verschillende projecten verschillende Ruby versies kunnen gebruiken is het handig meerdere Ruby versies naast elkaar te kunnen draaien. Wij raden rbenv aan aangezien het een stuk eenvoudiger (en probleemlozer werkt) dan rvm. Rbenv installeer je op de volgende manier:

• Mac OSX: Via brew: handleiding
• Linux: Via je favoriete package manager (rbenv) of via rechtstreeks via Github (zie rbenv#basic-github-checkout)

Op beide platformen moet rbenv worden opgestart bij het openen van de shell, dit kan op de volgende manier (vervang .bash_profile door je favoriete shell zijn profile of rc):

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

Na installatie en herladen van de shell zou type rbenv rbenv is a function of iets dergelijks moeten geven.

Het installeren van een nieuwe Ruby versie kan aan de hand van rbenv install [versie] (bv. rbenv install 2.2.2). De volledige lijst van mogelijke versies kan bekomen worden aan de hand van het commando rbenv list.

Rbenv zal normaal de globaal ingestelde Ruby versie gebruiken, tenzij de gebruiker (of het project) een andere versie specifieert door middel van een .ruby-version bestand met daarin het versienummer. Dit laatste kan door rbenv shell [versie] worden overschreven voor de huidige shell sessie. De globale Ruby versie kan worden aangepast door rbenv global [version].

Rbenv op Windows wordt niet gedaan, de installatie van Ruby kan via RubyInstaller for Windows.

Net zoals rbenv de versie van je Rails project beheert, beheert Bundler per project de verschillende versies van dependencies en gems. Wanneer bijvoorbeeld twee verschillende projecten twee verschillende versies van dezelfde gem gebruiken, zorgt Bundler dat deze netjes naast elkaar kunnen gebruikt worden.

Installatie van Bundler is zo simpel als gem install rbenv. Houd er rekening mee dat geïnstalleerde gems afhankelijk zijn van de door rbenv geactiveerde Ruby, het kan dus zijn dat je dit commando opnieuw moet uitvoeren na het installeren van een nieuwe Ruby versie.

Gems worden per project gespecifieerd in de Gemfile. Meer informatie over deze Gemfile kan hier worden verkregen.

Wanneer je een werkende rbenv en bundler setup hebt kan je beginnen aan een project:

1. Clone hiervoor eerst de repository van Git,
2. Controleer of de versie gespecifieerd in .ruby-version lokaal geïnstalleerd is,
3. Installeer die versie wanneer dit niet het geval is,
4. Installeer via bundle install de benodigde dependencies uit de Gemfile,
5. Voer bundle exec rake db:setup uit om het databankschema en de seeds in te laden,
6. Start de Rails server in development op via rails s.

Wanneer bij stap 4 fouten optreden is dit waarschijnlijk omdat de gem een system library nodig heeft, vaak voorkomende zijn: