How to let passenger restart after deployment with capistrano
Phusion Passenger changed the way how it gets restarted several times. Through the project's history, these all were valid:
sudo passenger-config restart-app /path/to/app
passenger-config restart-app /path/to/app
You should not need to know which one to use. Instead, the capistrano-passenger gem will choose the appropriate restart mechanism automatically based on your installed the passenger version.
Add to your
gem 'capistrano-passenger', require: false
Add to your
Declare which server role should be restarted (optional). Usually passenger tries to restart all servers with the
approle. If you have dedicated Sidekiq servers with the
approle, adjust the
passenger_rolessetting to exclude them.Copy
set :passenger_roles, :app # This is the default
Remove any homegrown
passenger:restarttasks. The gem will provide both, and hook itself after
See the project's readme document for more information.
It is possible you get an "error" message like this:
*** ERROR: You are not authorized to query the status for this Phusion Passenger instance. Please try again with 'sudo'.
This happens because your application never ran with the current passenger instance (probably due to no requests to it) and the
passenger-config command runs without superuser permissions. This won't stop or break your deploy as the
capistrano-passenger gem will execute the
passenger-config restart-app with the option
--ignore-app-not-running and due to that the command will exit with return code
0. With the next request to your application passenger will start your application based on the code you just deployed.