phusion/passenger-ruby-heroku-demo is one of the open-source repositories TopGit tracks, currently at 278 stars, written primarily in Ruby. Demonstrates running a Ruby app on Heroku with Phusion Passenger
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Running a Ruby app on Heroku with Phusion Passenger
Phusion Passenger is an application server, designed to be fast, robust and lightweight. By combining Heroku with Phusion Passenger, you can boost the performance of your apps, utilize the available resources on your dynos much more efficiently and increase its stability.
Phusion Passenger for Heroku brings the power of Nginx to your dynos. Nginx is an extremely fast and lightweight web server that powers 10% of the Internet. All the cool guys are rapidly switching to Nginx. Phusion Passenger replaces Thin and Unicorn, and makes full use of Nginx to serve your Ruby apps faster and better.
Here's a list of the benefits that using Phusion Passenger will bring you:
Static asset acceleration through Nginx - Don't let your Ruby app serve static assets, let Nginx do it for you and offload your app for the really important tasks. Nginx will do a much better job.
Multiple worker processes - Instead of running only one worker on a dyno, Phusion Passenger runs multiple worker on a single dyno, thus utilizing its resources to its fullest and giving you more bang for the buck. This approach is similar to Unicorn's. But unlike Unicorn, Phusion Passenger dynamically scales the number of worker processes based on current traffic, thus freeing up resources when they're not necessary.
Memory optimizations - Phusion Passenger uses less memory than Thin and Unicorn. It also supports copy-on-write virtual memory in combination with code preloading, thus making your app use even less memory when run on Ruby 2.0.
Request/response buffering - The included Nginx buffers requests and responses, thus protecting your app against slow clients (e.g. mobile devices on mobile networks) and improving performance.
Out-of-band garbage collection - Ruby's garbage collector is slow, but why bother your visitors with long response times? Fix this by running garbage collection outside of the normal request-response cycle! This concept, first introduced by Unicorn, has been improved upon: Phusion Passenger ensures that only one request at the same time is running out-of-band garbage collection, thus eliminating all the problems Unicorn's out-of-band garbage collection has.
JRuby support - Unicorn's a better choice than Thin, but it doesn't support JRuby. Phusion Passenger does.
More information about Phusion Passenger:
Website
Documentation
Support
Source code
Community discussion forum
Issue tracker
What people say
Tweet about us too or follow us on Twitter.
Creating a new app
Clone this repository and push it to Heroku:
git clone https://github.com/phusion/passenger-ruby-heroku-demo.git
cd passenger-ruby-heroku-demo
heroku create
git push heroku master
heroku open
Your app is now powered by Phusion Passenger!
Switching an existing app to Phusion Passenger
Phusion Passenger is a drop-in replacement for Thin and Unicorn and very easy to install.
Open your app's Gemfile. Remove the following lines if they exist:
gem "unicorn"
gem "thin"
gem "puma"
Insert:
gem "passenger"
Open your app's Procfile, or create one if you don't already have one. Remove lines like this:
bundle install
git commit -a -m "Switch to Phusion Passenger"
git push heroku master
Congratulations, you're now running on Phusion Passenger!
Configuration
Any configuration is done by customizing the arguments passed to the passenger command. The most important ones are:
--max-pool-size - The maximum number of worker processes to run. The maximum number that you can run depends on the amount of memory your dyno has.
--min-instances - If you don't want the number of worker processes to scale dynamically, then use this option to set it to a value equal to --max-pool-size.
--spawn-method - By default, Phusion Passenger preloads your app and utilizes copy-on-write (the "smart" spawning method). You can disable this by setting this option to direct.
--no-friendly-error-pages - If your app fails to start, Phusion Passenger will tell you by showing a friendly error page in the browser. This option disables it.
Please refer to the configuration reference for more information.
Status service
Passenger provides the passenger-status command, which displays a status report that tells you what application processes are currently running, how much memory and CPU they use, how many requests are being handled, etc.
However, passenger-status doesn't work out-of-the-box on Heroku because Heroku does not allow SSH access to its servers. For this reason, we have created the Passenger Status Service for making Passenger status reports work.
Please visit https://status-service.phusionpassenger.com/ for more information.
Passenger Enterprise
You can also use Phusion Passenger Enterprise on Heroku, but with a caveat:
Passenger Enterprise's rolling restarts don't work. You need to use Heroku's preboot facility for that.
Here are the instructions for running Passenger Enterprise on Heroku:
Using Passenger open source in development, Enterprise in staging and production
It is possible to use Passenger open source in development, while using Passenger Enterprise in staging production. This works by creating a binstub bin/passenger which will start either Passenger open source or Passenger enterprise, depending on the value of the RAILS_ENV environment variable. Then the user must use the bin/passenger binstub instead of using the passenger command directly.
First, ensure that your Gemfile contains both 'passenger' and 'passenger-enterprise-server' but in different groups, like this:
source 'https://rubygems.org'
source "https://download:#{your_download_key}@www.phusionpassenger.com/enterprise_gems"
group :development do
gem 'passenger', '>= 5.0.22'
end
group :staging, :production do
gem 'passenger-enterprise-server', '>= 5.0.22'
end
Second, create a binstub bin/passenger. This binstub will start Passenger open source in development, Passenger Enterprise in staging and production. The binstub must contain:
Does phusion/passenger-ruby-heroku-demo have a project website?
No homepage URL was recorded for phusion/passenger-ruby-heroku-demo in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
Does phusion/passenger-ruby-heroku-demo have any tags?
TopGit's last sync did not record any GitHub topics for phusion/passenger-ruby-heroku-demo. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on phusion/passenger-ruby-heroku-demo?
The most recent commit recorded on phusion/passenger-ruby-heroku-demo was 29 days ago, based on the GitHub push timestamp. The repository has 18 forks — one of the better signals of community interest.
Is phusion/passenger-ruby-heroku-demo open source?
TopGit's metadata for phusion/passenger-ruby-heroku-demo does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
Where do I read more about phusion/passenger-ruby-heroku-demo?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/phusion/passenger-ruby-heroku-demo is the definitive source.
Read full README in the tab above.
Curious whether passenger-ruby-heroku-demo is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about passenger-ruby-heroku-demo.