= Installing and Running Trac on Debian Sarge =

== Running from Trunk ==

There is a page on running from trunk on TracOnDebianFromTrunk 

== Non-Default packages ==
Sarge users who want to track Edgewall's latest version need to add a few lines to their '''/etc/apt/sources.list''' :
{{{
# Trac and clearsilver
deb http://ftp.edgewall.com/pub/debian sarge trac
}}}

Then update APT's cache :
{{{
 $ apt-get update
}}}

Whether the above steps to get Edgewall's version instead of Debian's were followed or not, installing Trac should be as simple as installing the '''trac''' package.

== Debian Sarge 3.1 (stable) ==
If you have Debian Sarge 3.1 you can directly start from this line, after you've installed Apache2.  From a basic installation of the final 3.1 stable, you'll need to install apache2, subversion, trac, and libapache2-svn.

=== Prerequisites ===

{{{
  $ apt-get install apache2
  $ apt-get install subversion
  $ apt-get install libapache2-svn
  $ apt-get install trac
}}}

 * Getting Subversion working:

   To create a Subversion project at '''/var/svn/project''', issue these commands to get SVN up and running:

_Note:_  As of this writing, the default Subversion package uses the BDB filesystem;   if this is acceptable, feel free to omit the extra argument to '''svnadmin create'''.

{{{
  $ mkdir /var/svn
  $ mkdir /var/svn/project
  $ mkdir /tmp/project
  $ mkdir /tmp/project/branches
  $ mkdir /tmp/project/tags
  $ mkdir /tmp/project/trunk
  $ svnadmin create /var/svn/project --fs-type fsfs
  $ svn import /tmp/project file:///var/svn/project -m "initial import"
  $ rm -rf /tmp/project
}}}

   Add the following to '''/etc/apache2/sites-available/default''':
{{{
#SVN dir
<Location /svn>
  DAV svn
  SVNParentPath /var/svn
  SVNAutoversioning on
  AuthType Basic
  AuthName "SVN - Your Project"
  AuthUserFile /etc/apache2/svn.passwd
  Require valid-user
</Location>
}}}
   Fix permissions to the repository, added user passwords, and restart apache2:
{{{
  $ find /var/svn/project -type f -exec chmod 660 {} \;
  $ find /var/svn/project -type d -exec chmod 2770 {} \;
  $ chown -R root.www-data /var/svn/project
}}}
   Enable installed apache modules
{{{
  $ a2enmod dav
  $ a2enmod dav_fs
}}}
   Add Subversion users.  Note the different syntax for creating the first user from creating each additional user.
{{{
cd /etc/apache2
htpasswd2 -c svn.passwd user1 (you'll be prompted for the password)
htpasswd2 svn.passwd user2 (you'll be prompted for the password)
}}}
   Restart Apache2.

{{{
  $ apache2 -k restart
}}}

Go to !http://servername.foo.com/svn/project to see the empty directories as imported. Do not move on to the next step until this works correctly!

 * Getting Trac running:
  
   These instructions will install a trac environment at '''/var/trac/project''', without using the mod_python extentions.  Initialize the Trac environment with the following commands:
{{{
  $ mkdir /var/trac
  $ trac-admin /var/trac/project initenv 
  $ find /var/trac/project -type f -exec chmod 660 {} \;
  $ find /var/trac/project -type d -exec chmod 2770 {} \;
}}}
   The '''trac-admin''' command above will prompt you to enter the project name, the path to the trac environment, and the path to the Trac templates directory; then it printed out a bunch of stuff. 

   Next, edit '''/etc/apache2/sites-available/default'''.  Comment out the existing {{{ScriptAlias}}} and  {{{<Directory "/usr/lib/cgi-bin">}}} directives.  To install trac at a URL like !http://servername.foo.com/proj , add this at the end:
{{{
Alias /trac "/usr/share/trac/htdocs"
ScriptAlias /proj /usr/share/trac/cgi-bin/trac.cgi
<Location "/proj">
 SetEnv TRAC_ENV "/var/trac/project"
</Location>
  
<Directory "/usr/share/trac/htdocs">
  Options Indexes MultiViews
  AllowOverride None
  Order allow,deny
  Allow from all
</Directory>
  
# You need something like this to authenticate users
<Location "/proj/login">
  AuthType Basic
  AuthName "project"
  AuthUserFile /var/www/trac.htpasswd
  Require valid-user
</Location>
}}}
   Providing /etc/apache2/svn.passwd in the space above will allow you to use the same usernames and passwords in both Subversion and Trac.  If you choose to authenticate, seperately, add Trac users, and restart Apache:
{{{
  $ cd /var/www
  $ htpasswd -c trac.htpasswd user1     (you'll be prompted for the password)
  $ htpasswd trac.htpasswd bar user2    (you'll be prompted for the password)  
  $ apache2 -k restart
}}}
   Finally, test by going to !http://servername.foo.com/proj/