Adds a 'rake debug' task to Ruby on Rails to restart Phusion Passenger with an interactive debugger connected
Failed to load latest commit information.
lib Prepare for release Aug 12, 2013
.gitignore First version Mar 11, 2012
Gemfile Add rake to Gemfile Aug 13, 2013
LICENSE.txt First version Mar 11, 2012 No longer maintained Feb 12, 2016
Rakefile First version Mar 11, 2012
ruby-debug-passenger.gemspec Update documentation with Byebug support Aug 12, 2013


Warning: This project is no longer maintained and may not work any more.


I wanted to use Phusion Passenger as an Apache module (not standalone) but still be able to use the interactive Ruby debugger.

Thanks to Adam Meehan I was able to do that, and I decided to make it into a reusable Gem.


  • Ruby on Rails 3.0+
  • Ruby 1.9+ (untested on 1.8 but it may work)
  • Ruby Debug / Debugger / Byebug
  • Phusion Passenger


Add this to your Gemfile if you are on Ruby 2.0:

gem "byebug"
gem "ruby-debug-passenger"

Or this if you are on Ruby 1.9:

gem "debugger"
gem "ruby-debug-passenger"

Or this if you are on Ruby 1.8 (but it hasn't been tested!):

gem "ruby-debug"
gem "ruby-debug-passenger"

Then run bundle install to install it.


Add debugger (Ruby 1.9 or lower) or byebug (Ruby 2.0+) anywhere in your Ruby code that you want to invoke the debugger. Or in an ERB template add <% debugger %> or <% byebug %> instead.

Run rake debug to restart Phusion Passenger and connect to the debugger. (You will be prompted to reload the app in your browser.)

Recommended reading



  • Support for byebug gem (David RodrĂ­guez) - #2


  • Support for debugger gem (Kai Middleton) - #1


  • Initial release


MIT License - see LICENSE.txt.