= Installing and Running Trac on Debian =
[[PageOutline()]]

'''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.''

'''Note:''' These Instructions are for ''Trac 0.11'' or better, but the package contains Trac 0.11! They also apply for Ubuntu.

'''Note:''' Debian 6.0 (code-named ''squeeze'', currently the ''stable'' release contains Trac 0.11.7 and some plugins for this version of Trac. The next Debian release (7.0, code-name ''wheezy'', currently the ''testing'' release) contains Trac 0.12.3 with plugins for this version Trac.

The '''Trac''' package is named '''trac''' and [http://packages.debian.org/lenny/trac is available] from the ''main'' archive.
This package is maintained by Debian [http://wiki.debian.org/Teams/PythonAppsPackagingTeam Python Applications Packaging Team].

== Where to get info about Trac in Debian ==

 * Package Information: http://packages.debian.org/trac [[BR]]
   Information about available versions, dependencies, file list and links to other resources.

 * Package Tracking System: http://packages.qa.debian.org/t/trac.html [[BR]]
   Summary of package information including available versions, maintainers and number of bugs (in Debian and Ubuntu)

 * Bug Tracking System: http://bugs.debian.org/trac [[BR]]
   All bugs filled against Trac in Debian and their status.


== Installing Trac ==

To install Trac just write in console:

{{{
apt-get install trac
}}}

This will get you the plain Trac installation. To see what additional packages are available, issue:
{{{
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. 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.

{{{
apt-get install trac-git
}}}

 * '''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
}}}

== 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 package'''||'''6 (squeeze)'''||'''6 (squeeze-backports)'''||'''7 (wheezy)'''||'''7 (wheezy-backports)'''||'''8 (jessie)'''||
||[DebianPTS:trac trac]||`0.11.7-4`||`0.12.2-1~bpo60+1`||`0.12.5-3~deb7u1`||`1.0.1-2~bpo70+1`||`1.0.2+dfsg-2`||
||[DebianPTS:trac-accountmanager trac-accountmanager]||`0.2.1+r7731-1`||—||`0.2.1+r7731-1`||—||`0.4.3-2`||
||[DebianPTS:trac-announcer trac-announcer]||—||—||`0.12.1+r10986-2`||—||`0.12.1+r10986-2`||
||[DebianPTS:trac-authopenid trac-authopenid]||`0.2.4-1`||—||`0.3.1-1`||—||`0.4.7-1`||
||[DebianPTS:trac-batchmodify trac-batchmodify]||—||—||`0.8.0+r10978-1`||—||—||
||[DebianPTS:trac-bitten trac-bitten]||`0.6b2.dfsg-3`||—||`0.6+final-3`||—||`0.6+final-3`||
||[DebianPTS:trac-bitten-slave trac-bitten-slave]||—||—||`0.6+final-3`||—||`0.6+final-3`||
||[DebianPTS:trac-bzr trac-bzr]||`0.3.2-1`||—||`0.4.2+bzr125-2`||—||—||
||[DebianPTS:trac-codecomments trac-codecomments]||—||—||—||—||`1.1.1+dfsg-1`||
||[DebianPTS:trac-customfieldadmin trac-customfieldadmin]||`0.2.2+r6485-1`||—||`0.2.6+r10460-1`||—||`0.2.6+r10460-1`||
||[DebianPTS:trac-datefieldplugin trac-datefieldplugin]||—||—||`0.7782-3`||—||—||
||[DebianPTS:trac-diavisview trac-diavisview]||—||—||`0.1+r11124-2`||—||`0.1+r11124-2`||
||[DebianPTS:trac-email2trac trac-email2trac]||`1.0.0-1`||—||`2.4.7-1`||—||`2.8.4-1`||
||[DebianPTS:trac-git trac-git]||`0.0.20100513-2`||`0.12.0.5+722342e-1~bpo60+1`||`0.12.0.5+722342e-1`||—||—||
||[DebianPTS:trac-graphviz trac-graphviz]||`0.7.5-1`||—||`0.7.5-1`||—||`0.7.5-1`||
||[DebianPTS:trac-httpauth trac-httpauth]||—||—||`1.1+r6675-1`||—||`1.1+r6675-1`||
||[DebianPTS:trac-icalviewplugin trac-icalviewplugin]||`0.7889-1`||—||`0.7889-1`||—||—||
||[DebianPTS:trac-includemacro trac-includemacro]||—||—||—||—||`3.0.0~r12030-1`||
||[DebianPTS:trac-ja-resource trac-ja-resource]||`0.11.5.ja1-1`||—||`0.12.2.ja1-1`||—||`1.0.ja1-0.1`||
||[DebianPTS:trac-jsgantt trac-jsgantt]||—||—||`0.9+r11145-1`||—||`0.9+r11145-1`||
||[DebianPTS:trac-mastertickets trac-mastertickets]||`2.1.3+r4179-1`||—||`3.0.2+20111224-2`||—||`3.0.2+20111224-2`||
||[DebianPTS:trac-mercurial trac-mercurial]||`0.11.0.7+svnr8365-3`||—||`0.12.0.28-1`||—||`1.0.0.3+hg8df754d9b36a-1.1`||
||[DebianPTS:trac-navadd trac-navadd]||—||—||—||—||`0.3+svn13554-1`||
||[DebianPTS:trac-odtexport trac-odtexport]||—||—||`0.6.0+svn10787-2`||—||`0.6.0+svn10787-2`||
||[DebianPTS:trac-privatetickets trac-privatetickets]||—||—||`2.0.3-3`||—||`2.0.3-3`||
||[DebianPTS:trac-roadmap trac-roadmap]||—||—||`0.4.1+r11241-1`||—||`0.4.1+r11241-1`||
||[DebianPTS:trac-sensitivetickets trac-sensitivetickets]||—||—||`0.21-1`||—||`0.21-1`||
||[DebianPTS:trac-spamfilter trac-spamfilter]||`0.2.1+svn6871-3`||—||—||—||—||
||[DebianPTS:trac-subcomponents trac-subcomponents]||—||—||—||—||`1.2.0+hga86f0413121f-4`||
||[DebianPTS:trac-subtickets trac-subtickets]||—||—||`0.1.1+253f019-1`||—||`0.1.1+253f019-1`||
||[DebianPTS:trac-tags trac-tags]||—||—||`0.6.0+svn11105-1`||—||`0.7+svn12392-1`||
||[DebianPTS:trac-translatedpages trac-translatedpages]||—||—||—||—||`1.0~svn11919-2`||
||[DebianPTS:trac-virtualticketpermissions trac-virtualticketpermissions]||—||—||`1.0.0+svn4153-1`||—||`1.0.0+svn4153-1`||
||[DebianPTS:trac-wikiprint trac-wikiprint]||`1.6+r5729-1`||—||`1.9.2-1.1`||—||—||
||[DebianPTS:trac-wikirename trac-wikirename]||`2.1.1-1`||—||—||—||—||
||[DebianPTS:trac-wikitablemacro trac-wikitablemacro]||`0.7785-1`||—||`0.7785-1`||—||—||
||[DebianPTS:trac-wysiwyg trac-wysiwyg]||`0.2+svn5931-1`||—||`0.12.0.3+r10725-1`||—||`0.12.0.3+r10725-1`||
||[DebianPTS:trac-xmlrpc trac-xmlrpc]||`1.0.6+svn6598-1`||—||`1.1.2+r10706-1`||—||`1.1.2+r10706-1`||

== Supporting other database backend 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
}}}
 

== 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 can also be [http://svn.debian.org/viewsvn/python-apps/packages/trac/trunk/debian/README.Debian?view=markup read online].