Installing Ruby on Rails 3 in Windows

Tagged: rubywindows
Photo by Jason D
Photo by Jason D

So last week I got a little tired of having to reboot my computer to dual-boot in a linux environment so that I could work on Rails stuff. Then I decided to try using Rails in Windows. Here’s a step by step guide on how to install rails in Windows.

Install Ruby 1.9

To install ruby on our windows machine we will be using RubyInstaller. RubyInstaller is the easiest way to install ruby in windows. It includes the Ruby execution environment and documentation.

First download and install The RubyInstaller.  Installing it to C:\Ruby192 is perfectly fine. I would not recommend installing Ruby to a place that has spaces in it, like the Program Files folder.

From here you can also download the DevKit as well. It allows you to have RubyGems build C-based gems. If you decide to get the DevKit, just install it to the C:\Ruby192\devkit folder for now.

So as you’re installing the RubyInstaller, Be sure to select, “Add Ruby Executables to your Path”

installing ruby windows

Now let’s verify that Ruby has been correctly installed. Get to your command prompt (Via Start -> Run -> type in cmd). Then type in:

ruby -v

Then it should reply with something similar to:

ruby 1.9.2p180 (2011-02-18) [i386-mingw32]

Now with your command prompt still open, let’s check to see that RubyGems was installed as well:

gem -v

installing ruby windows 2

Hey that wasn’t so difficult was it? I told you that RubyInstaller was easy 🙂

Install SqlLite3

So when running rails we would like to have a database to start off with without having to set up a local database connection. And of course, Windows does not support SqlLite right out of the box. Thus we will have to get it ourselves.

Go to the SQLite download page and find the precompiled binaries for windows section and download the sqlite-dll-win32-x86-3070603.zip

After unzipping that file, you should end up with the files sqlite3.dll and sqlite3.def. Copy both of those files into the C:\Ruby192\bin directory.

Also, while you’re still at the SqlLite download page you should pick up the shell file (sqlite-shell-win32-x86-3070603.zip) as well. The command line shell is useful for looking around in your sqlite3 databases. Copy the executable in the zip also to the C:\Ruby192\bin directory. You can verify that this is installed by typing:

sqllite3 -version

Now we should install the ruby bindings to SQLite3

gem install sqlite3

Install Rails 3

Rails is distributed by RubyGems. When you install Ruby, the RubyGems system is also installed. This makes it really easy to install Rails.

Install Rails by typing:

gem install rails

This should take a few minutes because it is installing several of the Rails dependencies (ActiveRecord, ActionPack, ActiveSupport, etc).

When that is done installing, verify that the correct version of Rails was installed by typing

rails -v

And it should respond with 3.0.7 or higher

Creating a Rails application

Go into your development directory and type in:

rails new project_name

Replace the project_name with the name of your new application. You should see it create a bunch of new directories and files

Now we need to install the gems we are going to use with this project. You can install the gems using:

bundle install

Once those gems are installed, we need to create the sqlite3 database in your project directory by typing in:

rake db:migrate

Once that is done, start your rails server by using the commands

rails server

installing ruby windows 3

And then navigate to http://localhost:3000/ to view your application. It should look something similar to this:

installing ruby windows 4 1024x572

Now get out there and start working on your web projects!


Profile picture

Written by who lives and works in Wisconsin building useful things, and thinks that pineapple on pizza is okay. You should follow them on Twitter