Waxing Lyrical

I have seen Trac before but until recently never really used it. In a project I've been working on with Codename:Tuesday we've been using Trac as the central source for bugs / tickets, documentation, UCTs etc. It's a very nice tool, with SVN integration and a ticketing system that has just what you need for development.

I run a server on CentOS and had a little trouble getting my install to work, so I decided to post this guide to getting trac up and running. This setup will allow you multiple instances of trac sites to support different projects. At the time of writing, my server runs CentOS 4.5 final.

This guide assumes all trac instances will exist under /srv/trac and all subversion instances will exist under /srv/svn and assumes you have subversion, apache and python installed.

Before you start, disable SELinux.

Repositories If you don't have them already, add Karanbir Singh's repositories:

Add the gpg key:

Install the prerequisites for Trac:

Add the following to your apache httpd.conf:

Setup your svn instance:

Run the following commands to create a trac instance (replacing "myproj" with the name of your project):

Remove anonymous write access to Trac:

add admin user priveledges:

setup special privs for other priveledged users

tweak everyone's base priveledges:

setup svn authorization; create the file /etc/httpd/conf/svn-auth.ini) with the following contents:

Create the password file and add a password for the admin user:

Create passwords for any other users:

Restart apache, and now you should be able to access your project at http://server/trac/myproj - login with the user and password you just setup and bob's yer wossname.

CAVEAT: you may find when you load the trac page you see "Error: Unsupported File Format". If you do, you need to disable the pdo_sqlite module as it's likely conflicting with the version installed by python. Edit the file /etc/php.d/pdo_sqlite.ini and comment out anything in the file by putting a # symbol at the beginning of each line.

Credits: I got a lot of this from here so many thanks to the original author - I've just modified a little and added more basic instructions.