===== Installing Ruby on Rails on Debian/Ubuntu =====

In this tutorial you will install Ruby, RubyGems, and Rails on Debian/Ubuntu.

==== Install Ruby from repository ====

<code>$ sudo apt-get install ruby-full build-essential</code>

==== Install Ruby from source ====

Prerequisite packages:
<code>$ sudo apt-get install build-essential libssl-dev libreadline5-dev zlib1g-dev checkinstall</code>
Download ruby sources:
<code>$ wget ftp://ftp.ruby-lang.org/pub/ruby/stable-snapshot.tar.gz</code>
then
<code>$ tar xvzf stable-snapshot.tar.gz</code>
Compiling and installing
<code>$ cd ruby/
$ ./configure
$ make
$ sudo checkinstall</code>
Test installation
<code>$ ruby -v</code>
show something like:
<code>ruby 1.8.7p5000 (2009-02-22) [i686-linux]</code>
Test libraries
<code>$ ruby -ropenssl -rzlib -rreadline -e "puts :Hello"</code>
Will show:
<code>Hello</code>
{{:getting-started:installation:information.png|}}//Note//: to manage this type of installation you can use aptitude or apt-get.

==== Install RubyGems ====

Download the latest version of RubyGems at the [[http://rubyforge.org/frs/?group_id=126|Rubyforge RubyGems page]].

{{:getting-started:installation:stop.png|}}Rails 2.2.2 requires v1.3.1 or higher.

<code>
$ cd ~
$ wget http://rubyforge.org/frs/download.php/70696/rubygems-1.3.7.tgz
$ tar xzvf rubygems-1.3.7.tgz
$ cd rubygems-1.3.7
$ sudo ruby setup.rb
$ sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
</code>

{{:getting-started:installation:information.png|}}//Note: It is possible to install RubyGems using apt-get. However, this is not recommended although you can still do it://
<code>
$ sudo apt-get install rubygems
$ sudo gem install rubygems-update --version=1.3.7
$ sudo gem install rails
$ rails --version
Rails 2.3.5
</code>


{{:getting-started:installation:information.png|}}//Note: Ruby 1.9.1 comes with rubygems. //

==== Install Rails via RubyGems ====

Once RubyGems is installed, use it to install Rails:

<code>$ sudo gem install rails</code>

==== Install MySQL DB server (optional) ====

By default, Rails includes the sqlite3 gem and is automatically configured to use it. To use MySQL instead, follow the following steps:

<code>
$ sudo apt-get install mysql-server mysql-client
$ sudo apt-get install libmysql-ruby libmysqlclient-dev
$ sudo gem install mysql
</code>

Rails assumes that the MySQL socket file will be found in /tmp/mysqld.sock. In Debian/Ubuntu, this is not the case. Be sure to change database.yml to reflect the actual location of the socket file:

<code>socket: '/var/run/mysqld/mysqld.sock'</code>

==== Test your Rails installation ====

To test your Rails installation, generate a new Rails project:

<code>$ rails myrailsapp</code>

If you are using MySQL, use the following command:

<code>$ rails myrailsapp -d mysql</code>

==== Deployment ====

Many popular web server configurations are available for Linux. Please see:

  * [[deployment/apache-mongrel|Apache + mongrel]]
  * [[deployment/apache-passenger|Apache + Passenger]]
  * [[deployment/nginx-mongrel|Nginx + mongrel]]
  * [[deployment/nginx-thin|Nginx + thin]]