1Catalyst::Manual::DeploUysmeerntC:oC:naDtteravilebylusottpe:md:eMnPatenSruelarlvD:eo:rcD(ue3mp)elnotyamteinotn::DevelopmentServer(3)
2
3
4
6 Catalyst::Manual::DevelopmentServer - Development server deployment
7
8 The development server is a mini web server written in Perl. However,
9 if you supply the "-f" option to the development server, it will load
10 the higher performance Starman server, which can be used as an
11 application server with a lightweight proxy web server at the front.
12
14 Start up the development server
15 script/myapp_server.pl -p 8080 -k -f --pidfile=/tmp/myapp.pid
16
17 You will probably want to write an init script to handle stop/starting
18 the app using the pid file.
19
20 Configuring Apache
21 Make sure mod_proxy is enabled and add:
22
23 # Serve static content directly
24 DocumentRoot /var/www/MyApp/root
25 Alias /static /var/www/MyApp/root/static
26
27 ProxyRequests Off
28 <Proxy *>
29 Order deny,allow
30 Allow from all
31 </Proxy>
32
33 # Need to specifically stop these paths from being passed to proxy
34 ProxyPass /static !
35 ProxyPass /favicon.ico !
36
37 ProxyPass / http://localhost:8080/
38 ProxyPassReverse / http://localhost:8080/
39
40 # This is optional if you'd like to show a custom error page
41 # if the proxy is not available
42 ErrorDocument 502 /static/error_pages/http502.html
43
44 You can wrap the above within a VirtualHost container if you want
45 different apps served on the same host.
46
47 Other web servers
48 The proxy configuration above can also be replicated with a different
49 frontend server or proxy, such as varnish, nginx, or lighttpd.
50
52 Catalyst Contributors, see Catalyst.pm
53
55 This library is free software. You can redistribute it and/or modify it
56 under the same terms as Perl itself.
57
58
59
60perl v5.32.0 Cataly2s0t2:0:-M0a7n-u2a8l::Deployment::DevelopmentServer(3)