Upgrading Passenger Enterprise + Nginx

How to upgrade Passenger Enterprise + Nginx depends on how Passenger Enterprise was installed. Please select the option most relevant to you.

Table of contents

  • Loading...

macOS (Homebrew)

If Passenger Enterprise was installed on macOS through Homebrew, then you can upgrade Passenger Enterprise as follows:

brew upgrade passenger-enterprise nginx-passenger-enterprise

If Passenger has been updated, but no new Nginx version has been released, then you must also reinstall Nginx against the latest version of Passenger:

brew reinstall nginx-passenger-enterprise

Debian packages (Debian, Ubuntu)

In July 2017, the Ubuntu 17.04 Zesty packages for Passenger were changed from a static to a dynamic module package. If you have the old package, please remove it and install the new package with the system Nginx:
  • sudo apt-get remove nginx-extras (if that fails, use: sudo dpkg --remove --force-remove-reinstreq nginx-extras)
  • sudo apt-get update && sudo apt-get install -y libnginx-mod-http-passenger-enterprise nginx

If Passenger Enterprise was installed through the Phusion Passenger APT repository, then you can upgrade Passenger Enterprise along with Nginx through APT using the following command:

sudo apt-get update
sudo apt-get upgrade

Don't see any updates?

If you don't see any updates, then there are two possible reasons:

  1. Our Debian packages haven't been released yet. When we release a new version of Passenger Enterprise, it typically takes 1-2 hours for our server to build Debian packages.
  2. If you are using a non-Long Term Support version of Ubuntu, then it is possible that we have dropped support for that Ubuntu version.

RPM packages (Red Hat, CentOS)

If Passenger Enterprise was installed through the Phusion Passenger YUM repository, then you can upgrade Passenger Enterprise along with Nginx through YUM using the following command:

sudo yum update

Don't see any updates?

If you don't see any updates, then maybe our RPM packages haven't been released yet. When we release a new version of Passenger Enterprise, it typically takes 2-3 hours for our server to build RPM packages.

Heroku

If you are using Passenger Enterprise on Heroku, then update the passenger-enterprise-server gem by running:

bundle update passenger-enterprise-server

Then commit and push to Heroku:

git commit -a -m "Upgrade Passenger Enterprise to latest version"
git push heroku master

Docker

Please refer to the passenger-docker website for upgrade instructions.

Source tarball

If Passenger Enterprise was installed through a source tarball, then please follow the source tarball upgrade guide.

RubyGems

If Passenger was installed through RubyGems, then upgrading Passenger involves going through the normal installation process again. Please follow the installation guide that is most relevant to you:

Please ignore the warning there that tells you that the guide is not for updates.

Be sure to install Nginx into the same prefix that you previously installed Nginx to.

When done, please don't forget to update the Nginx configuration snippet that the installer tells you about at the end.