= Installing and Running Trac on Debian Sarge (testing) =

== Notes from a debian sarge install ==

As has been previously pointed out, a Debian package does not exist, hence you need to build it yourself. This isn't ''too'' onerous if you know where you might get bitten. Hopefully the following should be of some use.

First you need the SQLite, Subversion and the related python modules (also grab python-dev if you don't have it installed already):

{{{
apt-get install sqlite python2.3-subversion python2.3-sqlite subversion
}}}


Clearsilver isn't available as a package so get clearsilver from http://www.clearsilver.net/ (tested [http://www.clearsilver.net/downloads/clearsilver-0.9.10.tar.gz 0.9.10])
(The symbolic link is needed to fix a bug in clearsilver 0.9.10)
{{{
tar xvfz clearsilver-0.9.10.tar.gz
cd clearsilver-0.9.10
./configure --with-python=/usr/bin/python
ln -s /usr/bin/python /usr/local/bin/python
make
make install
}}}

This should then allow you to build and initialise trac.

When you come to running it though you'll also have to add the env_module using the following line in your '''{{{/etc/apache/modules.conf}}}'''

{{{
LoadModule env_module /usr/lib/apache/1.3/mod_env.so
}}}

I then set up a trac.conf in my '''{{{/etc/apache/conf.d}}}''' folder like so

{{{
<VirtualHost local.trac>
    alias /trac/ "/usr/share/trac/htdocs/"
    ServerAdmin youremail@yourdomain.tld
    DocumentRoot /var/trac/myTrac
    ServerName local.trac
    ErrorLog /var/trac/myTrac/logs/error.log
    CustomLog /var/trac/myTrac/logs/access_log common
    AddHandler cgi-script cgi
    <Location "/cgi-bin/trac.cgi">
      SetEnv TRAC_DB "/var/trac/myTrac/tracdb/mydb"
      Options FollowSymLinks +ExecCGI
      AllowOverride None
    </Location>
</VirtualHost>
}}}
Don't forget to create those log folders though (apachectl configtest doesn't warn you about that one)

(Adapted and updated from an earlier guide by tim@pollenation.net)