====== Phusion Passenger / mod_rails ======

We've created Passenger packages for Ubuntu Hardy and Lucid - the Apache 'mod_rails' hosting solution written by the team at [[http://www.phusion.nl|Phusion]].

===== Brightbox APT Repository =====

The package is available from the [[docs:brightboxaptrepository|Brightbox apt repository]] at [[http://apt.brightbox.net]] and is called 'libapache2-mod-passenger'.

Brightboxes have the repository in place by default, but you can easily add the repository to your system with the following commands (if you're using Hardy, substitute 'lucid' for 'hardy'):

<code bash>
sudo sh -c 'echo "deb http://apt.brightbox.net lucid main" > /etc/apt/sources.list.d/brightbox.list'
sudo sh -c 'wget -q -O - http://apt.brightbox.net/release.asc | apt-key add -'
sudo apt-get update
</code>

===== Brightbox Launchpad PPA =====

You can also use our Launchpad PPA. It's focused just on Passenger, so doesn't have our other packages, but you might prefer that. It also has support for Ubuntu Maverick and Ubuntu Natty.

<code bash>
sudo apt-add-repository ppa:brightbox/passenger
sudo apt-get update
</code>

===== Installation =====

To install:

<code bash>
sudo apt-get install libapache2-mod-passenger
</code>

===== NGINX Support =====

We have a separate repository for the nginx packages. See [[http://blog.brightbox.co.uk/posts/nginx-passenger-3-ubuntu-packages|this blog post]] for more details.

===== Ruby Enterprise Edition =====

To take full advantage of Passenger, you should consider installing our [[docs:ruby-enterprise|Ruby Enterprise Edition packages]].

===== PHP Compatibility =====

Whilst Passenger works perfectly with the Apache prefork mpm, we recommend using the event mpm.  The event mpm is incompatible with mod_php, but you can very easily run PHP in FastCGI mode alongside Passenger.  See our [[docs:php|PHP docs]] for more information.


===== Support and feedback =====

You can get help with this package and/or feed back about your experiences on the [[http://forum.brightbox.co.uk/forums/passenger|Brightbox Passenger forum]].