Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A simple recipe for building an nginx + passenger RPM for CentOS.
branch: master

This branch is 1 commit ahead of causes:master

Failed to load latest commit information.
patches Compile Passenger module into Nginx ourselves.
README.markdown update to nginx-0.8.52+passenger2.2.15


A Recipe for an Nginx + Passenger RPM on CentOS

A simplified/revised version of swhitt's centos-apache-passenger, which is similar to jnstq's rails-nginx-passenger-ubuntu recipe but for Nginx + Passenger on CentOS. Also influenced by the deploy scripts used by EngineYard Solo.

Perform the following on a build box as root.

Create an RPM Build Environment

yum install rpmdevtools

Install Prerequisites for Nginx + Passenger RPM Creation

yum groupinstall 'Development Tools'
yum install ruby-devel openssl-devel zlib-devel pcre-devel rubygems git
gem install passenger -v 2.2.15

Hereafter, this process assumes that passenger-config --root returns a usable value for the location of Passenger's installed files. The RPM will build nginx-specific extensions for Passenger (by running rake nginx in Passenger's main directory) and will compile against the module in Passenger's ext/nginx/ directory.

Passenger's ext/nginx/HelperServer file is dynamically linked and must be present at runtime for the nginx integration to work correctly.

Download Nginx

cd ~/rpmbuild
curl -o SOURCES/nginx-0.8.52.tar.gz

Get Necessary System-specific Configs

cd /tmp
git clone git://
cp nginx-passenger-centos/{init,conf,patches}/* ~/rpmbuild/SOURCES/
cp nginx-passenger-centos/spec/nginx-passenger.spec ~/rpmbuild/SPECS/

Build the RPM

cd ~/rpmbuild/
rpmbuild -ba SPECS/nginx-passenger.spec

The resulting RPM will be:


When put this error

lib/ruby/gems/1.8/gems/passenger-2.2.15/ext/nginx/StaticContentHandler.c:69: error: 'ngx_http_request_t' has no member named 'zero_in_uri'

Delete these line from ${GEM_HOME}/passenger-2.2.15/ext/nginx/StaticContentHandler.c

if (r->zero_in_uri) {
  return NGX_DECLINED;
Something went wrong with that request. Please try again.