Installing and Running Trac on Debian
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
- Package Information: http://packages.debian.org/trac
Information about available versions, dependencies, file list and links to other resources.
- Package Tracking System: http://packages.qa.debian.org/t/trac.html
Summary of package information including available versions, maintainers and number of bugs (in Debian and Ubuntu).
- Bug Tracking System: http://bugs.debian.org/trac
All bugs filled against Trac in Debian and their status.
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.
Plugins in Debian
|Debian package||6 (squeeze)||6 (squeeze-backports)||7 (wheezy)||7 (wheezy-backports)||8 (jessie)|
Supporting other database backends than SQLite
Trac can support other database systems to store its information (wiki, tickets and user data).
apt-get install python-psycopg2
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.txtafter 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:
Latest version of this file can also be read online.