Creating a Production Ruby on Rails: nginx

I was talking to someone about a new rails project, and we asked about which server would be the best one to work on. Of course, me being a person who loves apt-get and hates RPM, I said one word.


But then I had to point him to a place to go to make things easier. The problem is that deploying a Rails app is rarely easy, especially one that actually is meant to not die. Not only that, but I don't always agree with all the tutorials. So I'm going to write a series of blog posts about how I'm going to do it. I'd recommend reading this post when it comes to installing ruby, rails and gems on Debian/Ubuntu but forget any of that Capistrano/Apache stuff that they talk about. I recommend vlad an nginx for setting up and deploying rails apps. We're going to talk about nginx in thsi post.

So, the first thing that is done when setting up a production server is to choose the webserver. Now, conventional wisdom says that when you're running Linux, you will most likely use Apache. Conventional Wisdom is very wrong, since Apache is a giant 800lb Gorilla of a webserver that has more features than you'll ever possibly need. It's great if you want to load things like mod_php or mod_python (which you would do with django, but that's the topic for another post), but it sucks if you want to use it for Ruby, since we're going to be forwarding everything to the mongrels anyway.

So, what do we use? We're going to use the Big Red Webserver from Russia, nginx. nginx is a nice http/reverse proxy server, with small, human readable files. The first thing that we're going to do is install it on Debian. Sudo as root and do this:

apt-get install nginx

See, isn't apt-get the coolest thing ever! Beats the crap out of yum! Anyway, what this just did was installed nginx, so in /etc/nginx, you are now going to have to delete your stock nginx file and create a new one. The first thing that you do is specify the user. It's best to create a user for this such as www-data.

user www-data;
worker_processes 1;
error_log /var/log/nginx/error.log debug;

Note, we also set the log files. Now, we have to set some basic settings, such as the mime-type includes, the connections that we will accept, and gzipping your data. Simple, commonsense stuff. This begins the http configuration block:

http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
sendfile on;
#tcp_nopush on;
keepalive_timeout 65;
tcp_nodelay on;
gzip on;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain;

OK, so far so good. Now, let's specify some mongrel clusters. Depending on your app, you may want more or less clusters to balance the load. I'd ideally say at least 2 per processor, but sometimes you may want to run less of these for some weird reason. So, here's what I have setup for a dual-processor machine.

upstream mongrel {

We're going to show how to setup this in mongrel later. This is what we have currently. Now, we have to specify the server.

server {
listen 80;
root /var/www/dogonrails/current/public;
index index.html index.htm;
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_redirect false;
if (-f $request_filename/index.html) {
rewrite (.*) $1/index.html break;
if (-f $request_filename.html) {
rewrite (.*) $1.html break;
if (!-f $request_filename) {
proxy_pass http://mongrel;
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;

Not much to see here. We're using nginx as a proxy to the mongrel servers. We point to public just like how we would in any rails application that's going to production, and we specify what we do in the case of a filename request. In the case that we request index, and index exists, we show the index.html page. Otherwise, we pass it all to mongrel. Then we use a closing brace to finish the scope.


Now, that was MUCH simpler than the beasts of Apache logs that you'd have to wade through to do the same thing. It's interesting to note that nginx is a lightweight proxying server, and is actually designed to do this, as opposed to Apache which is more general purpose, and is meant to load web apps using shared libraries which is always much faster than doing something like using mongrel.

I'm not saying that nginx is the right tool for every job, in fact, I would use think seriously about using Apache for a Python/Django project, but that's the topic of another post entirely. Stay tuned for my next post about Vlad the Deployer!