Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Mac OS X preference pane for easily configuring Rails applications with Passenger.
Ruby Nu Objective-C
branch: master

Merge pull request #73 from midwire/master

Change project settings to create a 64-bit binary.
latest commit 0342d3edbe
@Manfred Manfred authored
Failed to load latest commit information.
English.lproj Set image from the NIB instead of during setup.
Passenger.xcodeproj Upgrade to 64-bit client for Lion
bin Import the CLI we prepared earlier.
design Change icon.
doc Don't accept drops of paths which have already been configured.'
lib Add an unregister command.
resources Set up the Passenger module warning with an alert icon.
test Add an unregister command.
vendor/TouchJSON Replace a deprecated method.
.gitignore Automatically run tests when tests or implementation changes.
.kick Add an unregister command.
Info.plist Get the Passenger Pane to start as a 64-bit pane.
PassengerTest-Info.plist Compile framework for testing and add some basic specs for Application.
PassengerTest-Prefix.pch Compile framework for testing and add some basic specs for Application.
Passenger_Prefix.pch Make the ppane CLI output JSON instead of YAML.
README.rdoc Explain changes made in the experimental branch.
Rakefile Change the path to xcodebuild in the build tasks.
ppane.gemspec Bump Gem version to 0.1.1.



A Mac OS X system preference pane which aids in quickly setting up Rails applications with Phusion Passenger.

Features include:

  • Drag and drop support

  • Managing hostnames without cluttering /etc/hosts. It uses Directory Services.



Obviously required. Version 1.3:

Phusion Passenger

Also a no brainer. You'll need at least version 2.0.1, or 2.2.5 for OS X 10.6:

$ gem install passenger
$ passenger-install-apache2-module


PassengerPane comes bundled with RubyCocoa 1.0.1, nothing needs to be done by you, the user.

Unless you wish to use a custom Ruby, not the one that’s shipped with OS X, in which case you will have to install RubyCocoa from source as well. See for more info.

Apache 2

PassengerPane is designed to work with the default Apache 2 installation supplied by Apple on Mac OS X 10.5 and 10.6.

Included with the archive you'll find a file called “passenger_pane_config.rb.ports”, this file should be a drop in replacement to work with Apache 2 as installed by MacPorts. Replace Passenger.prefPane/Contents/Resources/passenger_pane_config.rb with this file or your own custom config.


Before creating a bug report, please check that you are using a RubyCocoa matching your Ruby installation and have met all other requirements mentioned above.

If the problem persist, or you have a feature request or better yet a patch, you can file a ticket at:



  • Rewrite in Cocoa for 64-bit support

  • Command-line utility

    • ~/Library/PreferencePanes/Passenger.prefPane/Contents/Resources/bin/ppane –help

    • Separately installable with RubyGems: gem install ppane

  • Fixed a bug that left hostnames in the Directory services after unregistering apps.


  • Mac OS X 10.6 support, although still in 32-bit mode:

    • Bundle RubyCocoa.framework in the preference pane. (Ticket #2 & #8)

    • Made the Apple Help work on both 10.5 and 10.6.

  • Added a check at launch, which verifies if all your application hostnames are registered in the hosts database (Directory Services). If not, add them. Obviously this is especially handy for people upgrading from 10.5 to 10.6, but also comes in handy when editing vhsost by hand.

  • Added preference pane Info.plist keys so the help shows up in the Help menu.

  • Use proper capitalization for the Apache conf “Directory” directive.

  • When the user changes the path to an application, also replace this in the @user_defined_data string. (Ticket #4)

  • Various source cleanups.


  • Rack support. Thanks to Kematzy for the original suggestion/work.

  • Fixed “issue” people had with the default non-vhost based directory not working anymore. Thanks to “spike” for debugging this.

  • Made the vhost config file extension configurable as well. By Felipe Mathies.

  • Backported RubyCocoa + Ruby 1.8.7 fix. By Grant Hollingworth.

  • Removed the “Allow mod rewrite rules” checkbox, we found it's not worth the UI real estate.


  • Honor custom environments that a user might have set.

  • Fixed problem with restarting Apache. After saving an application Apache should now automatically be restarted. Thanks to Ciarán Walsh.

  • Added support for ServerAlias and add those entries to the hosts db.

  • Reload the applications from disk when the preference pane is brought back to the front. Any changes made to the vhosts from elsewhere will be reflected in the UI.

  • Moved all hardcoded paths into a config module. Added a config for Apache 2 as installed by MacPorts. Thanks to Ciarán Walsh.

  • The host table list was editable. Thanks to Ciarán Walsh.

  • Fixed bugs in parsing custom user defined data in vhosts.

  • Create a tmp dir before touching restart.txt if none exists.

  • Replace underscores with hyphens in hostnames. Thanks to Bryan Liles.


See the LICENSE file.

Something went wrong with that request. Please try again.