Catalyst::Manual::Deployment::lighttpd::FastCGI - Deploying Catalyst with lighttpd
-=head4 Static file handling
+=head1 Lighttpd
+
+These configurations were tested with Lighttpd 1.4.7.
+
+=head2 Standalone server mode
+
+ server.document-root = "/var/www/MyApp/root"
+
+ fastcgi.server = (
+ "" => (
+ "MyApp" => (
+ "socket" => "/tmp/myapp.socket",
+ "check-local" => "disable"
+ )
+ )
+ )
+
+=head2 Static mode
+
+ server.document-root = "/var/www/MyApp/root"
+
+ fastcgi.server = (
+ "" => (
+ "MyApp" => (
+ "socket" => "/tmp/myapp.socket",
+ "check-local" => "disable",
+ "bin-path" => "/var/www/MyApp/script/myapp_fastcgi.pl",
+ "min-procs" => 2,
+ "max-procs" => 5,
+ "idle-timeout" => 20
+ )
+ )
+ )
+
+Note that in newer versions of lighttpd, the min-procs and idle-timeout
+values are disabled. The above example would start 5 processes.
+
+=head2 Non-root configuration
+
+You can also run your application at any non-root location with either of the
+above modes. Note the required mod_rewrite rule.
+
+ url.rewrite = ( "myapp\$" => "myapp/" )
+ fastcgi.server = (
+ "/myapp" => (
+ "MyApp" => (
+ # same as above
+ )
+ )
+ )
+
+For more information on using FastCGI under Lighttpd, visit
+L<http://www.lighttpd.net/documentation/fastcgi.html>
+
+
+=head2 Static file handling
Static files can be served directly by lighttpd for a performance boost.
)
}
-Which serves everything in the img, static, css directories
-statically, as well as the favicon file.
+This will serve everything in the C<img>, C<static>, and C<css>
+directories statically, as well as the favicon file.
+
+=head1 AUTHORS
+
+Catalyst Contributors, see Catalyst.pm
+
+=head1 COPYRIGHT
+
+This library is free software. You can redistribute it and/or modify it under
+the same terms as Perl itself.
+=cut