We provide an official Phusion Passenger APT repository. This APT repository contains Phusion Passenger packages for multiple versions of Debian and Ubuntu. These packages are automatically built by our build server after we push out a source release, and thus are always up to date with the official source releases.
If you use these packages to install Phusion Passenger then you do not need to run passenger-install-apache2-module or passenger-install-nginx-module. These packages contain all the binaries that you need.
Packages are available for the x86 and x86_64 architectures. Our policy is to support all Ubuntu LTS releases that are still supported by Canonical, plus the latest Ubuntu release, plus all Debian releases that are still supported by Debian.
2.3.1. Adding our APT repository
-
Install our PGP key. Packages are signed by "Phusion Automated Software Signing (auto-software-signing@phusion.nl)", fingerprint 1637 8A33 A6EF 1676 2922 526E 561F 9B9C AC40 B2F7.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 561F9B9CAC40B2F7
-
Add HTTPS support for APT. Our APT repository is stored on an HTTPS server.
sudo apt-get install apt-transport-https ca-certificates
-
Create a file /etc/apt/sources.list.d/passenger.list and insert one of the following lines, depending on your distribution.
-
Open source
-
##### !!!! Only add ONE of these lines, not all of them !!!! ##### # Ubuntu 14.04 deb https://oss-binaries.phusionpassenger.com/apt/passenger trusty main # Ubuntu 12.04 deb https://oss-binaries.phusionpassenger.com/apt/passenger precise main # Ubuntu 10.04 deb https://oss-binaries.phusionpassenger.com/apt/passenger lucid main # Debian 7 deb https://oss-binaries.phusionpassenger.com/apt/passenger wheezy main # Debian 6 deb https://oss-binaries.phusionpassenger.com/apt/passenger squeeze main
Enterprise
-
##### !!!! Only add ONE of these lines, not all of them !!!! ##### # Ubuntu 14.04 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt trusty main # Ubuntu 12.04 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt precise main # Ubuntu 10.04 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt lucid main # Debian 7 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt wheezy main # Debian 6 deb https://download:YOUR_DOWNLOAD_TOKEN@www.phusionpassenger.com/enterprise_apt squeeze main
You can find the correct value for YOUR_DOWNLOAD_TOKEN in the Customer Area.
-
-
Secure passenger.list and update your APT cache:
sudo chown root: /etc/apt/sources.list.d/passenger.list sudo chmod 600 /etc/apt/sources.list.d/passenger.list sudo apt-get update
2.3.2. Installing packages
![]() | You should install nginx-extras even if you have already installed an Nginx package from the official Debian/Ubuntu repository. This is because the Nginx binary that our packages supply is compiled with the Passenger module. |
-
Open source
-
-
Install the packages:
sudo apt-get install nginx-extras passenger
-
Edit /etc/nginx/nginx.conf and uncomment passenger_root and passenger_ruby.
Especially passenger_root is important: Phusion Passenger won’t work without it! If you don’t see a commented version of passenger_root inside nginx.conf, then you need to insert it yourself.
-
Restart Nginx:
sudo service nginx restart
Enterprise
-
-
Download your license key from the Customer Area and save it as /etc/passenger-enterprise-license.
-
Install the packages:
sudo apt-get install nginx-extras passenger-enterprise
-
Edit /etc/nginx/nginx.conf and uncomment passenger_root and passenger_ruby.
Especially passenger_root is important: Phusion Passenger won’t work without it! If you don’t see a commented version of passenger_root inside nginx.conf, then you need to insert it yourself.
-
Restart Nginx:
sudo service nginx restart
-
2.3.3. Inserting passenger_root into nginx.conf
During step 3 of the Installing packages subsection, you were instructed to uncomment the passenger_rootdirective in /etc/nginx/nginx.conf. If there is no commented version in there, then you need to insert it yourself.
First, run the following command and take note of its output:
/usr/bin/passenger-config --root
Next, insert the following snippet into /etc/nginx/nginx.conf, under the http block:
passenger_root whatever_value_you_got_from_previous_command;
Here is an example:
... http { # path-to-locations.ini is given to you by `passenger-config --root`. passenger_root /path-to-locations.ini; ... }
Once you’re done editing nginx.conf, continue with step 4.