= Installing and Running Trac on Debian =

'''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.
           They Also apply for Ubuntu.

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
}}}
or
{{{
aptitude install trac
}}}

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


There is also an important plugin to prevent ''spam'' on tickets, '''spamfilter'''


{{{
apt-get install trac-spamfilter
}}}

== 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 Apache Webserver ==

'''Trac''' on Debian depends on any webserver available, but it prefers Apache2 with modPython. It can also be installed using cgi, FastCGI, and wSGI.
To use wsgi on apache, you have to install apache's mod wsgi:
{{{
apt-get install libapache2-mod-wsgi
}}}


For fast configuration, please check ''README.Debian'' located in '''/usr/share/doc/trac''' .
For specific configurations, please check TracGuide and [http://trac.edgewall.org Trac's website].