Lighttpd

Recipes »

HowToSetupTrac » History » Revision 17

Revision 16 (rsenk330, 2009-12-16 00:24) → Revision 17/18 (mathieumg, 2011-02-10 22:28)

h1. How to setup trac with Lighttpd 


 "Trac":http://trac.edgewall.org/ is an enhanced wiki and issue tracking system for software development projects. 


 h2. Common setup using FastCGI 

 <pre> 
 $HTTP["host"] == "trac.example.com" { 
     server.document-root = "/www/htdocs/sites/trac.example.com" 
     alias.url              = ( 
         "/trac_prefix/chrome/common/" => "/usr/share/trac/htdocs/", 
     ) 
 
     # rewrite for multiple svn project 
     url.rewrite-final      = ( 
         "^/trac_prefix/[^/]+/chrome/common/(.*)" => "/trac_prefix/chrome/common/$1", 
     ) 


     $HTTP["url"] =~ "^/trac_prefix/chrome/" { 
         # no fastcgi 
     } # end of $HTTP["url"] =~ "^/trac_prefix/chrome/" 
     else $HTTP["url"] =~ "^/trac_prefix" { 
         fastcgi.server      = ( 
             "/trac_prefix" => (            # if trac_prefix is empty, use "/" 
                 ( 
                     # options needed to have lighty spawn trac 
                     "bin-path"          => "/usr/share/webapps/trac/0.9.3/hostroot/cgi-bin/trac.fcgi", 
                     "min-procs"         => 1, 
                     "max-procs"         => 1, 
                     "bin-environment" => ( 
                         "TRAC_ENV_PARENT_DIR" => "/var/lib/trac/", 
                     ), 

                     # options needed in all cases 
                     "socket"            => "/tmp/trac.sock", 
                     "check-local"       => "disable", 

                     # optional 
                     "disable-time"      => 1, 

                     # needed if trac_prefix is empty; and you need >= 1.4.23 
                     "fix-root-scriptname" => "enable", 
                 ), 
             ), 
         ) 
     } # end of $HTTP["url"] =~ "^/trac_prefix" 
 } # end of $HTTP["host"] == "trac.example.com" 
 </pre> 


 Change "/trac_prefix" (neither "/trac_prefix/" nor "trac_prefix/", nor "trac_prefix") to anything else or even remove it if you want. 

 If you only want one svn project, then replace "TRAC_ENV_PARENT_DIR" with "TRAC_ENV" and change "/var/lib/trac" to the correct subdirectory. 

 You can use [[spawn-fcgi:|spawn-fcgi]] to spawn the trac application too, of course. 
 <pre> 
 TRAC_ENV_PARENT_DIR=/var/lib/trac/ spawn-fcgi -n -s /tmp/trac.sock -- /usr/share/webapps/trac/0.9.3/hostroot/cgi-bin/trac.fcgi 
 </pre> 

 h2. Common setup using CGI 

 Take a look at the "updated Trac setup documentation":http://trac.edgewall.org/wiki/TracInstallPlatforms 

 h2. Fedora setup 

 <pre> 
 var.fcgi_binary="/usr/bin/python /usr/lib/python2.5/site-packages/Trac-0.11.4-py2.5.egg/trac/web/fcgi_frontend.py" # Change to point to correct version 
 $HTTP["host"] == "trac.example.com" { 
     fastcgi.server         = ( "/" => 
                              ( "trac" => 
                                ( "socket" => "/tmp/trac-fastcgi.sock", 
                                  "bin-path" => fcgi_binary, 
                                  "check-local" => "disable", 
                                  "bin-environment" => 
                                  ( "TRAC_ENV_PARENT_DIR" => "/path/to/trac", 
 				    "PYTHONPATH" => "/usr/lib/python2.5/site-packages", 
				    "PYTHON_EGG_CACHE" => "/tmp/trac" 
				  ), 
				  "fix-root-scriptname" => "enable", 
                                ) 
                              ) 
                            ) 
     $HTTP["url"] =~ "^/.*/login$" { 
         auth.require = ( "/" => ( 
             "method" => "digest", 
             "realm"    => "Trac", 
             "require" => "valid-user" 
             ) 
         ) 
     } 
 } 
 </pre> 

 h2. Separated setup 

 The webserver at lighttpd.net is living in a chroot which separates the webserver-root from the rest of the system and the subversion repositories. 

 As trac requires physical access it couldn't be installed in the "well documented way":http://trac.edgewall.org/wiki/TracInstall.  

 trac provides a seperated tracd which is started locally at port 9090: 

 <pre> 
 $ tracd -b 127.0.0.1 -p 9090 /path/to/trac/lighttpd/ 
 </pre> 

 Additionally, if you want to access your proxied trac installation with a base url other than /, you can add the following switch to the previous tracd command-line: 

 <pre> 
 --base-path=/some/path 
 </pre> 

 To forward all requests from the webserver to trac the [[lighttpd:Docs:ModProxy]] is used: 

 <pre> 
 $HTTP["host"] == "trac.lighttpd.net" { 
   # forward all requests at trac.lighttpd.net to the tracd 
   proxy.server = ("" => ( "trac" => ( "host" => "127.0.0.1", "port" => 9090 ))) 
 } 
 </pre>