-= Trac Installation Guide =
The Trac web-based project management tool is implemented as a server side
cgi-program. Trac is written in the Python programming language and store it's
data in a sqlite database.
The following dependencies have to be installed:
- * Python, version >= 2.1.
- * subversion, version >= 0.29.
- * pysqlite, version >= 0.4.3
- * ClearSilver, version >= 0.9.3
- * A CGI-capable webserver (only tested with Apache)
+ * Python, version >= 2.1. http://python.org/
+ * subversion, version >= 0.37. http://subversion.tigris.org/
+ * pysqlite, version >= 0.4.3. http://pysqlite.sf.net/
+ * ClearSilver, version >= 0.9.3. http://clearsilver.net/
+ * A CGI-capable web server (only tested with Apache)
- $ python ./setup.py build
- $ python ./setup.py install
+ $ python ./setup.py install
-== Initializing the database ==
+This will byte-compile the python source code and install it in the
+site-packages directory of your python installation. The directories templates,
+htdocs and wiki-default will be copied into $prefix/share/trac/ .
-Trac stores wiki pages, tickes and other information in a sqlite database.
-Sqlite databases ar just ordinary files on the harddrive, no database server is
+Initializing the database
+Trac stores wiki pages, tickets and other information in a sqlite database.
+Sqlite databases are just ordinary files on the hard drive, no database server
A new trac database can be created like this:
- $ trac
_admin .py /path/to/mydatabase.db initdb
+ $ trac-admin /path/to/mydatabase.db initdb
-NOTE: The database file have to be located in a directory where the webserver
+NOTE: The database file have to be located in a directory where the webserver
user has write permission to both the file and the directory.
-This creates a new database using default values. Some settings still need to
-be modified to get your Trac installation up and running. The following command
-will display the trac configuration:
+trac-admin will ask you where your subversion repository is located and where
+it can find the trac templates directory (the default value should be fine).
- $ trac_admin.py /path/to/mydatabase.db config list
-Most settings should be okey, but you have to verify that these settings are
+copy (or symlink) "trac/cgi-bin/trac.cgi" to you web servers /cgi-bin/
+directory. Of course you can configure apache to use the "trac/cgi-bin/"
+directory directly if you like.
- * general.repository_dir. This should be the path to the svn repository.
- * general.templates_dir. This should be the path to the trac template
-A config value is modified like this:
- $ trac_admin.py /path/to/mydatabase.db config set <name> <value>
-== Configuring Apache ==
-copy "trac/cgi-bin/trac.cgi" to you webservers /cgi-bin/ directory. Of course
-you can configure apache to use the "trac/cgi-bin/" directory directly if you
-Finally adjust the filenames and add this config snippet to your webserver:
+Finally adjust the filenames and add this config snippet to your web server:
Alias /trac/ "/where/you/put/trac/htdocs/"
# Trac need to know where the database is located
- SetEnv TRAC_DB "/somewhere/myproject.db"
+ SetEnv TRAC_DB "/somewhere/myproject.db"
-# You need this to
let users authenticate
+# You need this to users authenticate
- AuthUserFile /somewhere/trac.htpasswd
+ AuthUserFile /somewhere/trac.htpasswd
You should now have a working Trac installation at: