forked from phusion/passenger
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME
95 lines (63 loc) · 2.55 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
== Introduction
Phusion Passenger probably requires no introduction. We kindly refer the reader
to http://www.modrails.com/ for general information.
== Changes from Phusion Passenger ==
=== Defining other ruby versions ===
In your server config specify the following as many times as you like:
PassengerRubyAlt name executable
name = A name for this interpreter, to be used later as a shortcut.
executable = The full path to the ruby executable you want to register.
=== Choosing a ruby version ===
Specify the following in your <VirtualHost>, .htaccess, <Location>, <Directory>:
PassengerSelectRuby ruby
ruby = The short name given in the PassengerRubyAlt directive OR
The full path to one of the ruby executables specified in
PassengerRuby or PassengerRubyAlt directives OR
"default" for the default ruby executable.
If the chosen ruby is not registered in the server configuration,
the default ruby executable is used.
=== Example ===
httpd.conf:
PassengerRuby /usr/bin/rubyee18
PassengerRubyAlt rubyee18 /usr/bin/rubyee18
PassengerRubyAlt ruby18 /usr/bin/ruby18
PassengerRubyAlt ruby19 /usr/bin/ruby19
PassengerRubyAlt new /usr/bin/ruby19
The last two directives don't cause Passenger to load /usr/bin/ruby19 twice,
instead it just registers two short names.
The same applies to the first two lines.
virtualhost:
<VirtualHost *:80>
ServerName test.passenger.rubyee18
PassengerSelectRuby /usr/bin/rubyee18
</VirtualHost>
.htaccess:
PassengerSelectRuby ruby19
=== Limitations ===
* There is no directive yet to allow non-specified ruby executables.
* The will be no SpawnManager active until the first rails application is loaded.
* nginx is not supported yet.
== Installation
=== Regular installation
You can install either Phusion Passenger for Apache or for Nginx. Run either of
the following programs as root:
./bin/passenger-install-apache2-module
-OR-
./bin/passenger-install-nginx-module
That's it. :)
For troubleshooting, configuration and tips, please read the corresponding
Users Guide:
doc/Users guide Apache.html
doc/Users guide Nginx.html
These files are included in the source tarball, and may also be viewed online on
our website.
=== Installing via a gem
You may also first generate a .gem file, and then install that.
First, make sure that you have the following software installed:
- Doxygen: http://www.stack.nl/~dimitri/doxygen/
- Asciidoc: http://www.methods.co.nz/asciidoc/
Next, run:
rake package
The gem will be available under the 'pkg' folder.
== Legal
Phusion Passenger is a trademark of Hongli Lai & Ninh Bui.