{"id":669,"date":"2011-03-23T22:53:17","date_gmt":"2011-03-23T14:53:17","guid":{"rendered":"http:\/\/www.strongd.net\/?p=669"},"modified":"2011-03-23T22:53:17","modified_gmt":"2011-03-23T14:53:17","slug":"ruby-on-rails-with-nginx-on-centos-5","status":"publish","type":"post","link":"https:\/\/www.strongd.net\/?p=669","title":{"rendered":"Ruby on Rails with Nginx on CentOS 5"},"content":{"rendered":"

Ruby on Rails is a popular rapid development web framework that allows web designers and developers to implement fully featured dynamic web applications using the Ruby programming language. This guide describes the required process for deploying Ruby on Rails with Passenger and the nginx web server on CentOS 5.<\/p>\n

 <\/p>\n

These instructions work with the Linode platform. If you don’t have a Linode yet, sign up for a\u00a0Linux VPS<\/a> and get started today.<\/p>\n

\n
Contents<\/div>\n
Install Required Packages<\/div>\n
Install Passenger and Nginx<\/div>\n
Set up an Init Script for Nginx<\/div>\n
Install MySQL Support (optional)<\/div>\n
More Information<\/div>\n
License<\/div>\n<\/div>\n
<\/a><\/p>\n

Install Required Packages<\/h2>\n

Make sure your system is up to date by issuing the following command:<\/p>\n

yum update<\/pre>\n
Issue the following series of commands to install packages required for Ruby on Rails.<\/p>\n
yum groupinstall \"Development Tools\"\r\nyum install zlib-devel wget openssl-devel pcre pcre-devel make gcc gcc-c++ curl-devel<\/pre>\n
The version of Ruby in the CentOS repositories is fairly old; we’ll need to download and compile it ourselves. Check the\u00a0Ruby language site<\/a>\"External for a link to the newest stable version and substitute it for the link shown below. Execute the following sequence of commands to get Ruby installed.<\/p>\n
cd \/opt\r\nwget ftp:\/\/ftp.ruby-lang.org\/pub\/ruby\/1.9\/ruby-1.9.1-p376.tar.gz\r\ntar -zxvf ruby-1.9.1-p376.tar.gz\r\ncd ruby-1.9.1-p376\r\n.\/configure --bindir=\/usr\/bin --sbindir=\/usr\/sbin\/\r\nmake -j3\r\nmake install<\/pre>\n
Now we’ll need to install gems. Issue the following series of commands to download and install a fresh version. You may wish to check the\u00a0RubyForge files page<\/a>\"External for the most recent version.<\/p>\n
cd \/opt\r\nwget http:\/\/production.cf.rubygems.org\/rubygems\/rubygems-1.5.1.tgz\r\ntar -zxvf rubygems-1.5.1.tgz\r\ncd \/opt\/rubygems-1.5.1\/\r\nruby setup.rb<\/pre>\n
Update rubygems:<\/p>\n
gem update --system<\/pre>\n
Install the\u00a0rake<\/tt>,\u00a0rack<\/tt>, and\u00a0fastthread<\/tt> gems:<\/p>\n
gem install rake rack\r\ngem install fastthread --no-rdoc --no-ri<\/pre>\n<\/div>\n
<\/a><\/p>\n
Install Passenger and Nginx<\/h2>\n
Proceed to the\u00a0Phusion Passenger<\/a>\"External site and locate the link for the current source code tarball. Download it as follows (substitute the link for the current version):<\/p>\n
cd \/opt\r\nwget http:\/\/rubyforge.org\/frs\/download.php\/73563\/passenger-3.0.1.tar.gz\r\ntar xzvf passenger-3.0.1.tar.gz<\/pre>\n
Run the Phusion Passenger installer for Nginx:<\/p>\n
cd \/opt\/passenger-3.0.1\/bin\r\n.\/passenger-install-nginx-module<\/pre>\n
You’ll be greeted by the Phusion Passenger Nginx installer program. Press “Enter” to continue with the installation.<\/p>\n
\"Phusion<\/a>When prompted for the Nginx installation method, we recommend you choose “1” to allow the installer to automatically download, compile, and install Nginx for you. Unless you have specific needs that would necessitate passing custom options to Nginx at compile time, this is the safest way to proceed.<\/p>\n
Please do\u00a0not<\/strong> remove the Passenger files from\u00a0opt<\/tt> after the install. They need to stay in place or your install will not function correctly.<\/p>\n<\/div>\n
<\/a><\/p>\n
Set up an Init Script for Nginx<\/h2>\n
Nginx is now installed in\u00a0\/opt\/nginx<\/tt>, but there are no “init” scripts to control this process. Issue the following sequence of commands to download a script, move it to the proper directory, set the proper permissions and set system startup links:<\/p>\n
cd \/opt\r\nwget https:\/\/library.linode.com\/frameworks\/ruby-on-rails-nginx\/reference\/init-rpm.sh\r\nmv \/opt\/init-deb.sh \/etc\/rc.d\/init.d\/nginx\r\nchmod +x \/etc\/rc.d\/init.d\/nginx\r\nchkconfig --add nginx\r\nchkconfig nginx on<\/pre>\n
You can now start, stop, and restart Nginx just like any other server daemon. For example, to start the server, issue the following command:<\/p>\n
\/etc\/init.d\/nginx start<\/pre>\n
You can now start, stop, and restart Nginx just like any other server daemon. For example, to start the server, issue the following command:<\/p>\n
\/etc\/rc.d\/init.d\/nginx start<\/pre>\n
If you haven’t already configured your firewall to allow inbound HTTP connections, run the following command to do so now:<\/p>\n
system-config-securitylevel-tui<\/pre>\n
The configuration file for Nginx is located at\u00a0\/opt\/nginx\/conf\/nginx.conf<\/tt>. This is the file you’ll need to edit to add support for your Rails applications. A default server is already configured in this file, and it also contains examples for alternate virtual host and SSL configurations.<\/p>\n<\/div>\n
<\/a><\/p>\n
Install MySQL Support (optional)<\/h2>\n
If your application uses MySQL, install the database server by following our\u00a0MySQL on CentOS 5 guide<\/a>. Once it’s installed and configured properly, issue the following commands:<\/p>\n
yum install mysql-devel\r\ngem install mysql --no-rdoc --no-ri -- --with-mysql-dir=\/usr\/bin --with-mysql-lib=\/usr\/lib\/mysql --with-mysql-include=\/usr\/include\/mysql<\/pre>\n
 <\/p>\n<\/div>\n
<\/a><\/p>\n
More Information<\/h2>\n
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.<\/p>\n