Setting up a Rails Server and Deploying with Capistrano on Fedora from Scratch


This article and video tutorial will teach you how to setup a basic Fedora server for Rails and PostgreSQL deployments. First, we'll setup Apache and PostgreSQL. Then, we'll use phpPgAdmin to create our application's user and databases. After that, we'll setup the Ruby platform using Passenger to run our application. Once all the components are installed, we'll prep our application for deployment using Capistrano.

I'll show you how to use Capistrano to automate remote tasks and take advantage of other features.

On With The Show

Understanding the Deployment Process

There is always a lot of confusion around deploying Rails applications. This tutorial hopes to sort some of that out. Most people know LAMP: Linux, Apache, MySQL, and PHP. We will setup LAPR: Linux, Apache, PostgreSQL, and Ruby. Setting up a LAPR server is very similar to setting up a LAMP server. The only wrinkle is getting Rails to talk to Apache. Thankfully, there is Passenger aka mod\_rails. Passenger is like mod\_php. It makes running Rails applications easy as pie. In order to run a Rails application through Apache, create a virtual host pointing the document root to the applications public directory and you'll be riding on rails.

Capistrano is another part that people may not be familiar with. Capistrano is a Ruby gem designed to execute tasks on one or more remote machines. You'll need SSH access to use Capistrano. Capistrano, affectionately known as Cap, automates the deploy process. We can use cap to take our code from some a repo and push it to the server, stop/start/restart the server, write custom tasks required by our application (think install required gems), or disable/enable a maintenance page. Using cap is not required but it sure beats using FTP to copy all the files around! Cap's real power comes from the ability to write custom tasks in Ruby to manipulate the server. I've written a lot of applications that allow user file uploads. Then on the server side, some directory needs to be created with proper permissions for the uploads to succeed. It's easy enough to write a cap task to create the directory and set the permissions. Then, if you ever change servers, you can simply run the cap task to setup the server again. There are many things you can do with Capistrano. You could even automate this entire tutorial to set up any number of machines at once!

Tutorial Sandbox

In order to complete this tutorial, you'll need SSH + sudo access. If you don't have a spare server sitting around, you can create one in VirtualBox. You can easily create a new VM and network it with your host system. I did this for the tutorial. When you start your virtual machine, make sure you use a bridged adapter so your VM gets an IP on the same subnet. I started with a fresh install without any customization. If you have access to a VPS like SliceHost, you can use these instructions as well.

Be sure to view the screencast before analyzing the code below.

Creating The Deployer

Setting Up Postgres

Configuring Ruby, RubyGems, and Passenger

Creating the Deployer Folder

Configuring Apache

Complete Cap File