Edgewall Software

Version 153 (modified by anonymous, 5 years ago) ( diff )

Installing and Running Trac on Debian

The Trac package is named trac and is available from the main archive. This package is maintained by Debian Python Applications Packaging Team.

These instructions are for Trac 0.11 or better. They also apply to Ubuntu. Debian 6.0 (squeeze) contains Trac 0.11.7. Debian 7.0 (wheezy) contains Trac 0.12.3. Debian 8.0 (jessie) contains Trac 1.0.2.

Note: This page does not provide step-by-step instructions for installing and configuring all of Trac. It is just a reference for installing the Debian software packages and locating configuration files. You will need to read TracInstall for complete instructions on running and configuring Trac.

Where to get info about Trac in Debian

Installing Trac

To install Trac as a plain installation:

apt-get install trac

To see what additional packages are available:

apt-cache show trac

Supporting other Version Control Systems than Subversion

You can also install plugins that support other version control system besides Subversion: Their packages are:

  • trac-git: adds support for the Git distributed version control system:
apt-get install trac-git

If you are installing this on Debian or a Debian derived system, you can read the document /usr/share/doc/trac-git/README.Debian for more information on installing trac-git plugin under Debian.

  • trac-mercurial: adds support for the Mercurial distributed version control system:
apt-get install trac-mercurial
  • trac-bzr: adds support for the bzr distributed version control system:
apt-get install trac-bzr

Please note that some of those plugins are integrated into the main core as of Debian Jessie https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=754860

Other Trac plugins

Some widely used Trac plugins are packaged by Debian, so that they can be easily installed and are part of the Debian package universe. They can all be installed by:

apt-get install trac-"pluginname"

with pluginname replaced by e.g. spamfilter.

Plugins in Debian

Debian package6 (squeeze)6 (squeeze-backports)7 (wheezy)7 (wheezy-backports)8 (jessie)
trac0.11.7-40.12.2-1~bpo60+10.12.5-3~deb7u11.0.1-2~bpo70+11.0.2+dfsg-2
trac-accountmanager0.2.1+r7731-10.2.1+r7731-10.4.3-2
trac-announcer0.12.1+r10986-20.12.1+r10986-2
trac-authopenid0.2.4-10.3.1-10.4.7-1
trac-batchmodify0.8.0+r10978-1
trac-bitten0.6b2.dfsg-30.6+final-30.6+final-3
trac-bitten-slave0.6+final-30.6+final-3
trac-bzr0.3.2-10.4.2+bzr125-2
trac-codecomments1.1.1+dfsg-1
trac-customfieldadmin0.2.2+r6485-10.2.6+r10460-10.2.6+r10460-1
trac-datefieldplugin0.7782-3
trac-diavisview0.1+r11124-20.1+r11124-2
trac-email2trac1.0.0-12.4.7-12.8.4-1
trac-git0.0.20100513-20.12.0.5+722342e-1~bpo60+10.12.0.5+722342e-1
trac-graphviz0.7.5-10.7.5-10.7.5-1
trac-httpauth1.1+r6675-11.1+r6675-1
trac-icalviewplugin0.7889-10.7889-1
trac-includemacro3.0.0~r12030-1
trac-ja-resource0.11.5.ja1-10.12.2.ja1-11.0.ja1-0.1
trac-jsgantt0.9+r11145-10.9+r11145-1
trac-mastertickets2.1.3+r4179-13.0.2+20111224-23.0.2+20111224-2
trac-mercurial0.11.0.7+svnr8365-30.12.0.28-11.0.0.3+hg8df754d9b36a-1.1
trac-navadd0.3+svn13554-1
trac-odtexport0.6.0+svn10787-20.6.0+svn10787-2
trac-privatetickets2.0.3-32.0.3-3
trac-roadmap0.4.1+r11241-10.4.1+r11241-1
trac-sensitivetickets0.21-10.21-1
trac-spamfilter0.2.1+svn6871-3
trac-subcomponents1.2.0+hga86f0413121f-4
trac-subtickets0.1.1+253f019-10.1.1+253f019-1
trac-tags0.6.0+svn11105-10.7+svn12392-1
trac-translatedpages1.0~svn11919-2
trac-virtualticketpermissions1.0.0+svn4153-11.0.0+svn4153-1
trac-wikiprint1.6+r5729-11.9.2-1.1
trac-wikirename2.1.1-1
trac-wikitablemacro0.7785-10.7785-1
trac-wysiwyg0.2+svn5931-10.12.0.3+r10725-10.12.0.3+r10725-1
trac-xmlrpc1.0.6+svn6598-11.1.2+r10706-11.1.2+r10706-1

Supporting other database backends than SQLite

Trac can support other database systems to store its information (wiki, tickets and user data).

  • PostgreSQL:
apt-get install python-psycopg2
  • MySQL:
apt-get install python-mysqldb

Unfortunately there is a problem with mysql requirements for the version of trac that ships with Debian stretch (see bug 887944). The easiest workaround is to edit /usr/lib/python2.7/dist-packages/Trac-1.2.egg-info/entry_points.txt after install and remove the [mysql] suffix from:

trac.db.mysql = trac.db.mysql_backend[mysql]

Additional Trac files

Trac is installed in /usr/share/pyshared/trac. Documentation is in /usr/share/doc/trac as is traditional with Debian. It includes both Trac and Debian information as well as helper scripts. There are also man pages for tracd and trac-admin.

Configuring Trac Environment under Debian

Debian documentation contains everything you need to setup Trac Environment and make its web-interface accessible. It can be read with the command:

zless /usr/share/doc/trac/README.Debian.gz

Latest version of this file was also available (broken link) read online.

Note: See TracWiki for help on using the wiki.