How to install the latest version of the Agile-Trac


The Agile-Trac plugin is a combination of a  Trac plugin and a patch for  Trac. This makes the installation of the plugin a little more complicated than usual, but still relatively straight-forward. The reasons for requiring a patch in addition to the plugin are detailed on the InitialDiscussion page. Over time it is hoped that this requirement will be removed.


Step 1: Install the plugin

The easiest way to install the plugin is to use easy_install.


Upgrading the Agile-Trac Plugin

If you already have Agile-Trac installed you can use the -U flag to upgrade your plugin to the latest one,

easy_install -U

Step 2: Install the patch

The easiest way to 'patch' your  Trac install is to,

2.1 Locate and change to the  Trac installation directory

Note: The location of your  Trac install will depend on the version number, for example you might have  Trac 0.11 or a newer version like  Trac 0.11.1.


This will depend on your installation, for example with  Trac 0.11, this may work.

cd C:\Python25\Lib\site-packages\Trac-0.11-py2.5.egg


Do these commands as a user of sufficient privileges, for example as root.

This will depend on your distribution. For example in Debian Testing for  Trac 0.11 you might type:

cd /usr/lib/python2.5/site-packages/Trac-0.11-py2.5.egg/

2.2 Rename the trac folder contained in your existing  Trac installation


Either use Windows Explorer to change the name

move trac trac_orig


sudo mv trac trac_orig

2.3 Use  svn to checkout the patched version of trac from this site

There is a single unified patch that can be used to replace all trac versions on the 0.11 branch, so far this is up-to-date with the following releases:

svn co trac

Upgrading from an older patch

If you are using one of the older versioned patches,

then you will need to replace it with the new one.

  1. First moving the old directory away using the same technique described in section 2.2.
  2. Now check out the new unified patch as described above.

Step 3: Restart your trac server

Step 4: Enable the Agile-Trac plugin


  1. Enable from the Admin section in your trac web, or
  2. Specify all the Agile-Trac components as enabled in your trac.ini file,
agiletrac.api.agiletracsystem = enabled
agiletrac.env.agiletracsetup = enabled
agiletrac.workflow.agileticketworkflow = enabled

Step 5:  Upgrade your trac enviroment

trac-admin /path/to/trac/project upgrade

Step 6: Restart your trac server


Frequently Asked Questions

I receive an 'error: Unexpected HTML page found at ...' message when trying to use easy_install to install the plugin

The reason for this is that the current stable release of  setuptools does work well with Subversion 1.5.


You need to install the latest development branch of setuptools.

svn co

Then install it as root.

cd setuptools-0.6
python install

After installing the Agile-Trac plugin, I get an error when displaying the Roadmap page

See also ticket:57 and ticket:62.

Trac detected an internal error:

DatabaseError?: ORDER BY terms must not be non-integer constants


The solution appears to be to make sure you have up-to-date versions of sqlite3 and pysqlite2.