Changes between Initial Version and Version 1 of TracStandalone

08/22/06 22:21:42 (12 years ago)



  • TracStandalone

    v1 v1  
     1= Tracd = 
     3Tracd is a lightweight standalone Trac web server. In most cases it's easier to setup and runs faster than the [wiki:TracCgi CGI script]. 
     5== Pros == 
     7 * Fewer dependencies: You don't need to install apache or any other web-server. 
     8 * Fast: Should be as fast as the [wiki:TracModPython mod_python] version (and much faster than the [wiki:TracCgi CGI]). 
     10== Cons == 
     12 * Less features: Tracd implements a very simple web-server and is not as configurable as Apache HTTPD. 
     13 * No native HTTPS support: [ sslwrap] can be used instead, 
     14   or [ STUNNEL]. 
     16== Usage examples == 
     18A single project on port 8080. (http://localhost:8080/) 
     20 $ tracd -p 8080 /path/to/project 
     22With more than one project. (http://localhost:8080/project1/ and http://localhost:8080/project2/) 
     24 $ tracd -p 8080 /path/to/project1 /path/to/project2 
     27You can't have the last portion of the path identical between the projects since that's how trac keeps the URLs of the 
     28different projects unique. So if you use /project1/path/to and /project2/path/to, you will only see the second project. 
     30== Using Authentication == 
     32Tracd provides support for both Basic and Digest authentication. The default is to use Digest; to use Basic authentication, replace `--auth` with `--basic-auth` in the examples below, and omit the realm. 
     34If the file `/path/to/users.htdigest` contain user accounts for project1 with the realm "", you'd use the following command-line to start tracd: 
     36 $ tracd -p 8080 --auth project1,/path/to/users.htdigest, /path/to/project1 
     38''Note that the project “name” passed to the `--auth` option is actually the base name of the project environment directory."" 
     40Of course, the digest file can be be shared so that it is used for more than one project: 
     42 $ tracd -p 8080 \ 
     43   --auth project1,/path/to/users.htdigest, \ 
     44   --auth project2,/path/to/users.htdigest, \ 
     45   /path/to/project1 /path/to/project2 
     48== Generating Passwords Without Apache == 
     50If you don't have Apache available, you can use this simple Python script to generate your passwords: 
     53from optparse import OptionParser 
     54import md5 
     56# build the options 
     57usage = "usage: %prog [options]" 
     58parser = OptionParser(usage=usage) 
     59parser.add_option("-u", "--username",action="store", dest="username", type = "string", 
     60                  help="the username for whom to generate a password") 
     61parser.add_option("-p", "--password",action="store", dest="password", type = "string", 
     62                  help="the password to use") 
     63(options, args) = parser.parse_args() 
     65# check options 
     66if (options.username is None) or (options.password is None): 
     67   parser.error("You must supply both the username and password") 
     69# Generate the string to enter into the htdigest file 
     70realm = 'trac' 
     71kd = lambda x: md5.md5(':'.join(x)).hexdigest() 
     72print ':'.join((options.username, realm, kd([options.username, realm, options.password]))) 
     76See also: TracInstall, TracCgi, TracModPython, TracGuide