Differences
This shows you the differences between two versions of the page.
|
docs:phusion-passenger [2011/08/05 12:22] johnleach added nginx note |
docs:phusion-passenger [2012/04/13 12:38] (current) johnleach updated with latest docs |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Phusion Passenger / mod_rails ====== | ====== 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]]. | + | We maintain Ubuntu packages for Phusion Passenger - the Apache 'mod_rails' hosting solution written by the team at [[http://www.phusion.nl|Phusion]]. |
| - | ===== Brightbox APT Repository ===== | + | ===== Apache ===== |
| - | The package is available from the [[docs:brightboxaptrepository|Brightbox apt repository]] at [[http://apt.brightbox.net]] and is called 'libapache2-mod-passenger'. | + | ==== Brightbox Passenger APT Repository ==== |
| - | 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'): | + | Our packages are now hosted on Launchpad. It's focused just on Passenger, so doesn't have our other packages. |
| + | |||
| + | You can add our repository very simply: | ||
| <code bash> | <code bash> | ||
| - | sudo sh -c 'echo "deb http://apt.brightbox.net lucid main" > /etc/apt/sources.list.d/brightbox.list' | + | sudo apt-add-repository ppa:brightbox/passenger |
| - | sudo sh -c 'wget -q -O - http://apt.brightbox.net/release.asc | apt-key add -' | + | |
| sudo apt-get update | sudo apt-get update | ||
| </code> | </code> | ||
| - | ===== Brightbox Launchpad PPA ===== | + | === Ubuntu 8.04 Hardy === |
| - | 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. | + | |
| + | If you're on the older Ubuntu 8.04 Hardy release, the ''apt-add-repository'' command isn't available so you have to install the repository and the key by hand: | ||
| <code bash> | <code bash> | ||
| - | sudo apt-add-repository ppa:brightbox/passenger | + | sudo sh -c 'echo "deb http://ppa.launchpad.net/brightbox/passenger/ubuntu hardy main" > /etc/apt/sources.list.d/brightbox-passenger.list' |
| + | sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys C3173AA6 | ||
| sudo apt-get update | sudo apt-get update | ||
| </code> | </code> | ||
| ===== Installation ===== | ===== Installation ===== | ||
| - | |||
| - | To install: | ||
| <code bash> | <code bash> | ||
| Line 32: | Line 33: | ||
| </code> | </code> | ||
| - | ===== NGINX Support ===== | + | And reload apache and you're ready to go. |
| - | 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. | + | ===== NGINX ===== |
| - | ===== Ruby Enterprise Edition ===== | + | We have a separate repository for the nginx packages: |
| - | To take full advantage of Passenger, you should consider installing our [[docs:ruby-enterprise|Ruby Enterprise Edition packages]]. | + | <code bash> |
| + | sudo apt-add-repository ppa:brightbox/passenger-nginx | ||
| + | sudo apt-get update | ||
| + | </code> | ||
| - | ===== PHP Compatibility ===== | + | Then installed nginx: |
| - | 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. | + | <code bash> |
| + | sudo apt-get install nginx-full | ||
| + | </code> | ||
| + | You’ll then need to enable the Passenger module, which can be usually done like this: | ||
| - | ===== Support and feedback ===== | + | <code bash> |
| + | cat <<EOF > /etc/nginx/conf.d/passenger.conf | ||
| + | passenger_root /usr/lib/phusion-passenger; | ||
| + | EOF | ||
| + | </code> | ||
| - | 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]]. | + | ===== 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. | ||