Source

trac-ticketlinks / README.tracd

Diff from to

README.tracd

 Trac in stand-alone mode
 ========================
-Trac 0.7 introduces among many other important features, the capability to run
+
+Trac 0.7 introduced among many other important features, the capability to run
 Trac as a stand-alone server (daemon), without a web server.
 
-*** NOTE:  THIS IS STILL AN EXPERIMENTAL FEATURE ***
-
-As of writing, tracd is still experimental, but we encourage testing it and
-providing feedback so we can improve it. Tracd supports all features of
-the CGI version (trac.cgi), and can serve multiple projects from a single
-server instance.
+Tracd supports all features of the CGI version (trac.cgi), 
+and can serve multiple projects from a single server instance.
 
 Running tracd
 -------------
-tracd [options] <database> [database] ...
-Options:
 
-    -a --auth [project],[htdigest_file],[realm]
-    -p --port [port]\t\tPort number to use (default: 80)
-    -b --hostname [hostname]\tIP to bind to (default: '')
+  tracd [options] <database> [database] ...
 
+  Options:
 
-Example:
+-a, --auth <project,htdigest_file,realm>    Per-project authentication information
+-p, --port <port>                           Port number to use (default: 80)
+-b, --hostname <hostname>                   IP to bind to (default: '')
+
+
+Example 1: Single Project (non-authenticated)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
   $ tracd -p 9090 /var/trac/myproject
 
+Example 2: Multiple Projects (authenticated)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+  $ tracd -p 9090 \
+     -a projectA,/var/trac/htdigest.ALPHA,ALPHA  \
+     -a projectB,/var/trac/htdigest.ALPHA,ALPHA  \
+     /var/trac/projectA \
+     /var/trac/projectB
+
+The file ``htdigest.ALPHA`` can be generated using the Apache2 tool ``htdigest``
+(be carefull *NOT* to use ``htpasswd`` here).
 
 Feedback and bug reports
 ------------------------
+
 Please provide feedback on tracd using the issue tracker or the mailing list.
 
- Submit a bug report:  http://projects.edgewall.com/trac/newticket/
+ Submit a bug report:  http://projects.edgewall.com/trac/newticket?component=tracd
    Mailing list info:  http://projects.edgewall.com/trac/wiki/MailingList
 
 
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.