= 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.

== Dependencies ==

The following dependencies have to be installed:

 * [http://www.python.org/ Python], version >= 2.1.
 * [http://subversion.tigris.org/ subversion], version >= 0.29.
 * [http://pysqlite.sf.net/ pysqlite], version >= 0.4.3
 * [http://clearsilver.net/ ClearSilver], version >= 0.9.3
 * A CGI-capable webserver (only tested with Apache)

== Installing Trac ==
{{{
	$ python ./setup.py build
	$ python ./setup.py install
}}}
== Initializing the database ==

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 required.

A new trac database can be created like this:

 {{{$ trac_admin.py /path/to/mydatabase.db initdb}}}

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.py /path/to/mydatabase.db config list}}}

Most settings should be okey, but you have to verify that these settings
are correct:
 * general.repository_dir. This should be the path to the svn repository.
 * general.templates_dir. This should be the path to the trac template directory.

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}}}" and "{{{trac/cgi-bin/trac_auth.cgi}}}" to 
you webservers {{{/cgi-bin/}}} directory. Of course you can configure apache
to use the "{{{trac/cgi-bin/}}}" directory directly if you like.

Finally adjust the filenames and add this config snippet to your webserver:
 
{{{
Alias /trac/ "/where/you/put/trac/htdocs/"
# Trac need to know where the database is located
<Location "/cgi-bin/">
  SetEnv TRAC_DB "/somewhere/myproject.db"
</Location>

# Uncomment this to let users authenticate
<Location "/cgi-bin/trac_auth.cgi">
  AuthType Basic
  AuthName "trac"
  AuthUserFile /somewhere/trac.htpasswd
  Require valid-user
</location>

}}}

Enjoy!

--------------------------
TracGuide <- TracGuide -> TracAdmin.