Changes between Initial Version and Version 1 of TracStandalone

Timestamp:

Oct 11, 2005, 12:24:32 AM (19 years ago)

Author:

trac

Comment:

--

TracStandalone

@@ +1 @@
+= Tracd =
+
+Tracd is a lightweight stand-alone Trac server. In most cases it's easier to setup and runs faster than trac.cgi.
+
+
+== Pros ==
+
+ * Fewer dependencies: You don't need to install apache or any other web-server.
+ * Fast: Should be as fast as the TracModPython version (much faster than the cgi).
+
+== Cons ==
+
+ * Less features: Tracd implements a very simple web-server and is not as configurable as apache.
+ * Only htdigest authentication: Tracd can currently only authenticate users against apache-htdigest files.
+ * No native https support: [http://www.rickk.com/sslwrap/ sslwrap] can be used instead,
+   or [http://lists.edgewall.com/archive/trac/2005-August/004381.html STUNNEL].
+
+== Usage examples ==
+
+A single project on port 8080. (http://localhost:8080/)
+{{{
+ $ tracd -p 8080 /path/to/project
+}}}
+With more than one project. (http://localhost:8080/project1/ and http://localhost:8080/project2/)
+{{{
+ $ tracd -p 8080 /path/to/project1 /path/to/project2
+}}}
+With htdigest authentication. The file /tmp/users.htdigest contain user accounts for project1 with the realm "mycompany.com".
+{{{
+ $ tracd -p 8080 --auth project1,/tmp/users.htdigest,mycompany.com /path/to/project1
+}}}
+htdigest authentication can also be used for more than one project.
+The digest file can be shared:
+{{{
+ $ tracd -p 8080 
+   --auth project1,/tmp/users.htdigest,mycompany.com 
+   --auth project2,/tmp/users.htdigest,mycompany.com 
+   /path/to/project1 /path/to/project2
+}}}
+
+== Tracd on Windows ==
+
+tracd also works on Windows. 
+But on that platform, the sensitivity on multithreading issues is high,
+and you ''might'' have problems (i.e. crashes of the Python interpreter).
+If this happens, you can force tracd to operate in single-threaded mode:
+{{{
+#!text/x-diff
+Index: trac/web/standalone.py
+===================================================================
+--- trac/web/standalone.py      (revision 1862)
++++ trac/web/standalone.py      (working copy)
+@@ -124,7 +124,7 @@
+         return auth['username']
+
+
+-class TracHTTPServer(ThreadingMixIn, HTTPServer):
++class TracHTTPServer(HTTPServer):
+
+     projects = None
+}}}
+
+Please also report any such issue, as they are believed to be fixed by now.
+
+
+== Generating passwords on Windows ==
+
+If you don't have Apache available, you can use this Python script to generate your passwords (code borrowed heavily from #845):
+
+{{{
+from optparse import OptionParser
+import md5
+
+# build the options
+usage = "usage: %prog [options]"
+parser = OptionParser(usage=usage)
+parser.add_option("-u", "--username",action="store", dest="username", type = "string",
+                  help="the username for whom to generate a password")
+parser.add_option("-p", "--password",action="store", dest="password", type = "string",
+                  help="the password to use")
+(options, args) = parser.parse_args()
+
+# check options
+if (options.username is None) or (options.password is None):
+   parser.error("You must supply both the username and password")
+   
+# Generate the string to enter into the htdigest file
+realm = 'trac'
+kd = lambda x: md5.md5(':'.join(x)).hexdigest()
+print ':'.join((options.username, realm, kd([options.username, realm, options.password])))
+}}}
+
+----
+See also: [source:trunk/README.tracd#latest README.tracd], TracGuide, TracInstall, TracModPython