<?xml version="1.0" encoding="UTF-8"?>
<wiki-page>
  <author>Dimitrij Denissenko</author>
  <content>Setting up Apache &amp; "Passenger":http://modrails.com is incredibly easy. Both provide a very stable and reliable combination for production usage.

This is a very brief and quick but effective introduction, there are probably hundreds of blog posts and HOWTOs on the web describing the set-up in more detail (please simply use a search engine). 

h3. Step 1: Install the passenger GEM

{{{
sudo gem install passenger
}}}

h3. Step 2: Install the Apache module

{{{
sudo passenger-install-apache2-module 
}}}

This launches the interactive Passenger installation. Just follow the instructions! The procedure automatically detects the OS and check all requirements. If a potential problem is found, it provides a very detailed information about its resolution.

In the end of the installation it provides configuration instructions for loading the modules into Apache and configuring the +VirtualHost+. Usually, you only need to add a few lines to the configuration an restart the Apache server. That's it!

Check also out the "User Guide":http://modrails.org/documentation/Users%20guide%20Apache.html for details or more advanced configuration options.

h2. Installing to a subpath.

If you wish to install Retrospectiva to a subpath rather than your domain root (ie, accessible at www.domain.com/appname), then in addition to configuring Apache as per the instructions in the Passenger User Guide, you will need to add the following to your config/runtime/custom.rb (create one if it doesn't exist).

{{{
ActionController::Base.relative_url_root = "/&lt;sub-uri&gt;"
}}}

h2. Optimizing.

This is a list of tips to make your retrospectiva faster.

h3. Passenger tips.

Apache configuration from "stackoverflow":http://stackoverflow.com/questions/853532/slow-initial-server-startup-when-using-phusion-passenger-and-rails

</content>
  <created-at type="datetime">2008-07-30T13:01:40+01:00</created-at>
  <title>Apache Passenger configuration</title>
  <updated-at type="datetime">2009-08-02T11:11:05+01:00</updated-at>
  <version type="integer">10</version>
</wiki-page>
