Skip to content


Subversion checkout URL

You can clone with
Download ZIP
100644 41 lines (32 sloc) 1.91 KB
b20b0a9 @FooBarWidget Add a packaging guide.
FooBarWidget authored
1 Notes for packagers
2 -------------------
3 By default Phusion Passenger locates all of its resource files under its
4 source root directory, however it also supports FHS-complaint packaging.
6 Resource files are located through constants defined in phusion_passenger.rb.
7 This file automatically detects whether it's FHS-packaged or not by
8 checking whether ../Rakefile exists (when packaged, "../Rakefile" evaluates
9 to something like "/usr/lib/ruby/1.8/.." and so returns false).
11 Packagers should pay attention to the following:
12 - Documentation like "Users guide Apache.html" must be located
13 in /usr/share/doc/phusion_passenger.
14 - Phusion Passenger has a Ruby extension called
15 This must be located in
17 /usr/lib/phusion_passenger/native_support/<SOME ARCH NAME>
19 where "<SOME ARCH NAME>" can be obtained by running the following
20 command from the Phusion Passenger source root:
22 ruby -Ilib -rphusion_passenger/platform_info -e \
23 'puts PlatformInfo.ruby_extension_binary_compatibility_ids.join("-")'
25 - There must be a full copy of the Phusion Passenger source tree located
26 in /usr/lib/phusion_passenger/source. The reasons are as follows:
28 * passenger-install-nginx-module and Phusion Passenger Lite must compile
29 Nginx, and this process requires the Phusion Passenger source code to
30 be available.
31 * is strongly tied to the Ruby interpreter it was
32 compiled for and may not work with a different Ruby interpreter. Since
33 the user can change the active Ruby interpreter at will by changing the
34 PassengerRuby Apache directive or the passenger_ruby Nginx directive,
35 Phusion Passenger recompiles on-the-fly if it is run
36 in a different Ruby interpreter.
38 We urge packagers to specify gcc, g++ and make as dependencies. Without
39 the source code and without a compiler toolchain, Phusion Passenger will
40 still work, except for the aforementioned features.
Something went wrong with that request. Please try again.