= 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.2 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-get 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'''||'''Version in stable'''||'''Version in unstable or testing'''||


== 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].