= Installing and Running Trac on Debian = '''Note:''' ''This page does not provide step-by-step instructions for installing and configuring all of Trac. Use this page as a reference for installing the Debian software packages and the locations of configuration files, but you will need to read TracInstall and the other documentation sections for complete instructions on running and configuring Trac.'' '''Note:'''These Instructions are for ''Trac 0.11'' or better. They Also apply for Ubuntu. (Note: installs 0.10.4-2 on Ubuntu Gutsy as of 8/13/08) The '''Trac''' package is named '''trac''' and is available from the ''main'' archive. This package is Team Maintained by [http://alioth.debian.org/projects/pkg-trac Debian Trac Packaging Team]. == Where To get info about trac in debian == * Package Information: http://packages.debian.org/trac Shows information about available versions, dependencies, file list and links to other resources. * Package Tracking System: http://packages.qa.debian.org/t/trac.html Shows the summary of all info about the package, including available versions, maintainers and number of bugs (in debian and ubuntu) * Bug Tracking System: http://bugs.debian.org/trac Show all bugs filled against trac and their status. == Installing Trac == To install '''trac''' just write in console: {{{ apt-get install trac }}} This will get you the plain '''trac''' installation. == 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 suport 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 suport for the mecurial distributed version control system {{{ apt-get install trac-mercurial }}} * '''trac-bzr''' :: adds suport 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''' (or '''/usr/share/trac'''). Documentation for trac is in /usr/share/doc/trac/ as is traditional with debian. Both trac and debian trac related documentation are placed there. For more documentation on trac you can read the tracd and trac-admin man pages. == 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].