Ruby on Rails - Installation
To develop a web application using Ruby on Rails Framework, you need to install the following software −
- The Rails framework
- A Web Server
- A Database System
We assume that you already have installed a Web Server and a Database System on your computer. You can use the WEBrick Web Server, which comes with Ruby. Most web sites, however, use Apache or lightTPD web servers in production.
Rails works with many database systems, including MySQL, PostgreSQL, SQLite, Oracle, DB2 and SQL Server. Please refer to a corresponding Database System Setup manual to setup your database.
Let's look at the installation instructions for Rails on Windows, Mac OS X, and Linux.
Rails Installation on Windows
Follow the below given steps for installing Ruby on Rails.
Step 1: Check Ruby version -
First, let's check to see if you already have Ruby installed. Bring up a command prompt and type ruby -v. If Ruby responds, and if it shows a version number at or above 2.2.2, then type gem --version. If you don't get an error, skip Install Ruby step. Otherwise, we'll install a fresh Ruby.
Step 2: Install Ruby -
If Ruby is not installed, then download an installation package from rubyinstaller.org. Follow the download link, and run the resulting installer. This is an exe like rubyinstaller-2.2.2.x.exe and will be installed in a single click. You may as well install everything . It's a very small package, and you'll get RubyGems as well along with this package. Please check the Release Notes for more detail.
Step 3: Install Rails -
install Rails: With Rubygems loaded, you can install all of Rails and its dependencies using the following command through command line −
C:\> gem install rails
NOTE: The above command may take some time to install all dependencies. Make sure you are connected to the internet while installing gems dependencies.
Step 4: Check Rails version -
Use the following command to check the rails version.
tp> rails -v
Congratulations! You are now on Rails over Windows.
Rails Installation on Linux
We are installing Ruby On Rails on Linux using rbenv. It is a lightweight Ruby Version Management Tool. The rbenv provides easy installation procedure, manage various versions of Ruby, and a solid envronment for developing Ruby on Rails applications.
Follow the below given steps for installing Ruby on Rails using rbenv tool.
Step 1: Install prerequisite dependencies -
First of we have to install git - core and some ruby dependences, which are help to install Ruby on Rails. Use the following command for installing Rails dependencies using yum.
tp> sudo yum install -y git-core zlib zlib-devel gcc-c++ patch readline readline-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison curl sqlite-devel
Step 2: Install rbenv -
Now we will install rbenv and set the appropriate environment variables. Use the folloing set of commands to get rbenv for git ripository.
tp> git clone git://github.com/sstephenson/rbenv.git .rbenv tp> echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile tp> echo 'eval "$(rbenv init -)"' >> ~/.bash_profile tp> exec $SHELL tp> git clone git://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build tp> echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bash_profile tp> exec $SHELL
Step 3: Install Ruby -
Bofore install Ruby, First determine which version of ruby that you want to install. We will install Ruby 2.2.1. Use the following command for installing Ruby.
tp> rbenv install -v 2.2.3
Use the following command for setting up the current Ruby version as default.
tp> rbenv global 2.2.3
Use the following command to verify the Ruby version.
tp> ruby -v
ruby 2.2.3p173 (2015-08-18 revivion 51636) [X86_64-linux]
Ruby provides a keyword gem for installing the suported dependencies we called them gems. If you don't want to install the documentation for Ruby-gems, then use the following command for it.
tp> echo "gem: --no-document" > ~/.gemrc
There after it is better to install the Bundler gem, because it helps to manage your application dependencies. Use the following command to install bundler gem.
tp> gem install bundler
Step 4: Install Rails -
The following command for installing rails of 4.2.4 version.
tp> install rails -v 4.2.4
Use the following command to make rails executable available.
tp> rbenv rehash
Use the following command for checking the rails version.
tp> rails -v
tp> Rails 4.2.4
tp> sudo yum -y install epel-release
Use the following command for installing Node.js package.
tp> sudo yum install nodejs
Congratulations! You are now on Rails over Linux.
Step 6: Install Database -
By default Rails uses sqlite3, But you may want to install MySQL, PostgreSQL or other RDBMS. This is optional if you have the database install you may skip this step and it is not mandatory that you have a dtabase install to start the rails server. For this tutorial we are using PostgreSQL database. Therefore use the following commands to install PostgreSQL.
tp> sudo yum install postgresql-server postgresql-contrib
Accept the prompt, by responding with a y. Use the following command ro create a PostgreSQl database cluster.
tp> sudo postgresql-setup initdb
Use the following command start and enable PostgreSQL.
tp> sudo systemctl start postgresql tp> sudo systemctl enable postgresql
Keeping Rails Up-to-Date
Assuming you have installed Rails using RubyGems, keeping it up-to-date is relatively easy. The same command we can use in both windows and linux platform. Issue the following command −
tp> gem update rails
Output: The following illustration you seen is the windows command prompt. The linux terminal also provides the same output.
This will automatically update your Rails installation. The next time you restart your application, it will pick up this latest version of Rails. While giving this command, make sure you are connected to the internet.
You can verify if everything is setup according to your requirements or not. Use the following command to create a demo project.
tp> rails new demo
This will generate a demo rail project, we will discuss about it later. Currently we have to check if the environment is setup or not. Next, use the following command to run WEBrick web server on your machine.
tp> cd demo tp> rails server
It will generates auto code to start the server
Now open your browser and type the following address text box.
It should display a message, something like, "Welcome aboard" or "Congratulations".