Find file History
Pull request Compare This branch is 289 commits behind chef-boneyard:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Installs passenger for Apache 2.



  • [COOK-859] - don't hardcode module path
  • [COOK-539] - use --auto for installation
  • [COOK-608] - remove RailsAllowModRewrite from web_app.erb
  • [COOK-640] - use correct development headers on RHEL


  • Upgrade to passenger 3.0.7
  • Attributes are all "default"
  • Install curl development headers
  • Move PassengerMaxPoolSize to config of module instead of vhost.



Tested on Ubuntu 10.04. Should work on any Ubuntu/Debian platforms.


Opscode cookbooks:

  • apache2
  • build-essential


  • passenger[:version] - Specify the version of passenger to install.
  • passenger[:max_pool_size] - Sets PassengerMaxPoolSize in the Apache module config.
  • passenger[:root_path] - The location of the passenger gem.
  • passenger[:module_path] - The location of the compiled passenger apache module.


For example, to run a Rails application on passenger:

include_recipe "rails"
include_recipe "passenger"

web_app "myproj" do
  docroot "/srv/myproj/public"
  server_name "myproj.#{node[:domain]}"
  server_aliases [ "myproj", node[:hostname] ]
  rails_env "production"

A sample config template is provided, web_app.conf.erb. If this is suitable for your application, add 'cookbook "passenger"' to the define above to use that template. Otherwise, copy the template to the cookbook where you're using web_app, and modify as needed. The cookbook parameter is optional, if omitted it will search the cookbook where the define is used.

License and Author

Author:: Joshua Timberman ( Author:: Joshua Sierles ( Author:: Michael Hale (

Copyright:: 2009-2011, Opscode, Inc Copyright:: 2009, 37signals Coprighty:: 2009, Michael Hale

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.