This guide shows all the steps to correctly install a ​trac system on a Ubuntu 7.04 Server. Please feel free to contact me (Luis) at any time with corrections or sugestions. This guide will be constantly updated but you see ​the original on the madlabs page.

This guide focuses on several things that I missed throughout the documentation, both official and unofficial:

• Everything configured from scratch with authentication, multiple projects and mod_python
• Not losing time explaining the decisions here. This is specifically to have multiple repositories, authentication and mod_python on Ubuntu. I never fork() the guide to give other possibilities
• The guide is pretty complete. After following the instructions here, my next step was to update my subversion reposity and continue on creating users and project environments. The esential is completelly covered here
• And if you're using a fresh instalation of Feisty Fawn and follow these instructions strictly, it will all be finished within 5 minutes!!!

Enjoy and comment!

Apache

• The first step is to install Apache.

$ sudo apt-get install apache2

apt-get configures everything you need and your webroot will be configured to /var/www. Ubuntu (actually, Debian) divides apache websites (virtualhost) in a set of directories under /etc/apache2/sites-available and has two utilites to configure them: a2ensite and a2dissite. We'll make use of these tools throughout this guide.

Subversion

The idea with our subversion instalation is to have a main directory and several repositories under it. We'll be setting /svn as our subversion parent dir and then create /svn/project1, /svn/project2, etc as needed. This second step will configure subversion, set apache to use mod_dav_svn and enable authentication through the digest method.

• We start by apt-getting the packages

$ sudo apt-get install subversion libapache2-svn

• We'll now configure mod_dav_svn and enable the mod_auth_digest module. We start by editing /etc/apache2/mods-enabled/dav_svn.conf

$ sudo vim /etc/apache2/mods-enabled/dav_svn.conf

This file probably has already a set of directives in it. I just show here the final version without the comments and changed to enable digest authentication:

<Location /svn>
 DAV svn
 SVNParentPath /svn

 ####### BASIC
 AuthType Basic

 AuthName "Subversion Repository"
 AuthUserFile /etc/apache2/dav_svn.passwd
 AuthzSVNAccessFile /etc/apache2/authz_svn.access

 Require valid-user
</Location>

• The next step is to create a user for subversion.

$ sudo htpasswd -cm /etc/apache2/dav_svn.passwd luis
New password: my_password
Re-type new password: my_password

• Additionally we'll create the authorization file for our users

  $ sudo vim /etc/apache2/authz_svn.access
  

• And add the following rule for our user. In this case, we'll be allowing him full access to the teste repository.

[teste:/]
luis = rw

• Finally we restart apache.

$ sudo apache2ctl restart

• Our next task is to create the subversion parent dir and a repository, and add a dummy project to it:

  $ sudo mkdir /svn
  $ sudo svnadmin create /svn/teste
  
  $ sudo mkdir /tmp/teste
  $ sudo mkdir /tmp/teste/branches
  $ sudo mkdir /tmp/teste/tags
  $ sudo mkdir /tmp/teste/trunks
  
  $ sudo chmod -R 777 /svn
  $ sudo chown -R www-data:www-data /svn
  
  $ sudo svn import /tmp/teste http://localhost/svn/teste -m "initial import" --username luis
  
  $ sudo rm -rf /tmp/teste
  

We can now point a browser to ​http://localhost/svn/teste and an authentication pop-up should apear and, after that, our repository. It is a good time to read some more on the "Per-Directory Access Control" part of the subversion book. One part of the security involved in this instalation only has to do with Subversion so some reading on ​Per-Directory Access Control might be useful at this time.

trac

Let's now head for the instalation of the trac system. For trac to work we'll be needing python and a number of other packages. Then we'll have to create a trac environment for each repository we want trac to serve.

• Let's start with apt-getting the needed packages

$ sudo apt-get install trac libapache2-svn libapache2-mod-python libapache2-mod-python-doc

• trac needs a directory to put the environments on where apache can read/write. We'll also add a symlink to this directory so it's easier to get there:

$ sudo mkdir /var/lib/trac
$ sudo chown -R www-data:www-data /var/lib/trac
$ sudo ln -s /var/lib/trac/ /trac

• Now we need another site for apache:

$ sudo vim /etc/apache2/sites-available/trac

• And add the following code to it:

<Location /trac>
 SetHandler mod_python
 PythonHandler trac.web.modpython_frontend
 PythonOption TracEnvParentDir /var/lib/trac
 PythonOption TracUriRoot /trac
</Location>

<LocationMatch "/trac/[^/]+/login">
 AuthType Basic
 AuthName "Trac"
 AuthUserFile /etc/apache2/dav_svn.passwd
 Require valid-user
</LocationMatch>

• Let's now enable this site:

$ sudo a2ensite trac
Site trac installed; run /etc/init.d/apache2 reload to enable.
$ sudo  /etc/init.d/apache2 reload
Reloading web server config...                                                     [ OK ]

• The final step is to initialize the trac environment for our project. The only thing I had to fill in here was the name of my projecto and the path to my subversion repository:

$ sudo trac-admin /trac/teste initenv
Creating a new Trac environment at /trac/teste
Trac will first ask a few questions about your environment
in order to initalize and prepare the project database.
Please enter the name of your project.
This name will be used in page titles and descriptions.
Project Name [My Project]> O Teste Final
Please specify the connection string for the database to use.
By default, a local SQLite database is created in the environment
directory. It is also possible to use an already existing
PostgreSQL database (check the Trac documentation for the exact
connection string syntax).
Database connection string [sqlite:db/trac.db]>
Please specify the type of version control system,
By default, it will be svn.
If you don't want to use Trac with version control integration,
choose the default here and don't specify a repository directory.
in the next question.
Repository type [svn]>
Please specify the absolute path to the version control
repository, or leave it blank to use Trac without a repository.
You can also set the repository location later.
Path to repository [/path/to/repos]> /svn/teste
Please enter location of Trac page templates.
Default is the location of the site-wide templates installed with Trac.
Templates directory [/usr/share/trac/templates]>
Creating and Initializing Project
Installing default wiki pages
/usr/share/trac/wiki-default/TracTicketsCustomFields => TracTicketsCustomFields
/usr/share/trac/wiki-default/WikiPageNames => WikiPageNames
/usr/share/trac/wiki-default/TracUnicode => TracUnicode
/usr/share/trac/wiki-default/TracChangeset => TracChangeset
/usr/share/trac/wiki-default/TracTickets => TracTickets
/usr/share/trac/wiki-default/WikiStart => WikiStart
/usr/share/trac/wiki-default/WikiFormatting => WikiFormatting
/usr/share/trac/wiki-default/TracQuery => TracQuery
/usr/share/trac/wiki-default/InterMapTxt => InterMapTxt
/usr/share/trac/wiki-default/InterWiki => InterWiki
/usr/share/trac/wiki-default/TracAdmin => TracAdmin
/usr/share/trac/wiki-default/TracLinks => TracLinks
/usr/share/trac/wiki-default/TracModPython => TracModPython
/usr/share/trac/wiki-default/TracEnvironment => TracEnvironment
/usr/share/trac/wiki-default/WikiRestructuredText => WikiRestructuredText
/usr/share/trac/wiki-default/TracInstall => TracInstall
/usr/share/trac/wiki-default/WikiDeletePage => WikiDeletePage
/usr/share/trac/wiki-default/CamelCase => CamelCase
/usr/share/trac/wiki-default/TracAccessibility => TracAccessibility
/usr/share/trac/wiki-default/TracTimeline => TracTimeline
/usr/share/trac/wiki-default/TracReports => TracReports
/usr/share/trac/wiki-default/TracWiki => TracWiki
/usr/share/trac/wiki-default/TracRoadmap => TracRoadmap
/usr/share/trac/wiki-default/WikiProcessors => WikiProcessors
/usr/share/trac/wiki-default/TracSearch => TracSearch
/usr/share/trac/wiki-default/WikiHtml => WikiHtml
/usr/share/trac/wiki-default/TracIni => TracIni
/usr/share/trac/wiki-default/WikiRestructuredTextLinks => WikiRestructuredTextLinks
/usr/share/trac/wiki-default/RecentChanges => RecentChanges
/usr/share/trac/wiki-default/TracNotification => TracNotification
/usr/share/trac/wiki-default/TracBackup => TracBackup
/usr/share/trac/wiki-default/TracPermissions => TracPermissions
/usr/share/trac/wiki-default/TracBrowser => TracBrowser
/usr/share/trac/wiki-default/SandBox => SandBox
/usr/share/trac/wiki-default/InterTrac => InterTrac
/usr/share/trac/wiki-default/WikiNewPage => WikiNewPage
/usr/share/trac/wiki-default/TracInterfaceCustomization => TracInterfaceCustomization
/usr/share/trac/wiki-default/TracSyntaxColoring => TracSyntaxColoring
/usr/share/trac/wiki-default/TracPlugins => TracPlugins
/usr/share/trac/wiki-default/TracUpgrade => TracUpgrade
/usr/share/trac/wiki-default/TracSupport => TracSupport
/usr/share/trac/wiki-default/WikiMacros => WikiMacros
/usr/share/trac/wiki-default/TracImport => TracImport
/usr/share/trac/wiki-default/TracLogging => TracLogging
/usr/share/trac/wiki-default/TracGuide => TracGuide
/usr/share/trac/wiki-default/TracRevisionLog => TracRevisionLog
/usr/share/trac/wiki-default/TracFastCgi => TracFastCgi
/usr/share/trac/wiki-default/TracCgi => TracCgi
/usr/share/trac/wiki-default/TracRss => TracRss
/usr/share/trac/wiki-default/TracStandalone => TracStandalone
/usr/share/trac/wiki-default/TitleIndex => TitleIndex
Indexing repository

---------------------------------------------------------------------
Project environment for 'O Teste final' created.

You may now configure the environment by editing the file:

 /var/lib/trac/teste2/conf/trac.ini

If you'd like to take this new project environment for a test drive,
try running the Trac standalone web server `tracd`:

 tracd --port 8000 /var/lib/trac/teste2

Then point your browser to http://localhost:8000/teste.
There you can also browse the documentation for your installed
version of Trac, including information on further setup (such as
deploying Trac to a real web server).

The latest documentation can also always be found on the project
website:

 http://trac.edgewall.org/

Congratulations!

At this point we still have to reset the ownership of the repository to the www-data user so that the database file can be accessed. Also, it's always a good idea to restart apache, just in case…

$ sudo chown -R www-data:www-data /var/lib/trac
$ sudo apache2ctl restart

• At this point we are still without any authentication. We'll start by removing permissions to the anonymous user, allowing him only to see the initial page. Then we'll also set our main user as the trac's root:

$ sudo trac-admin /trac/teste permission remove anonymous BROWSER_VIEW CHANGESET_VIEW FILE_VIEW LOG_VIEW MILESTONE_VIEW REPORT_SQL_VIEW REPORT_VIEW ROADMAP_VIEW SEARCH_VIEW TICKET_CREATE TICKET_MODIFY TICKET_VIEW TIMELINE_VIEW WIKI_CREATE WIKI_MODIFY

$ sudo trac-admin /trac/teste permission add luis TRAC_ADMIN

• You can now check ​http://localhost/trac and you should see a list with all the projects for which you have a trac environment set. clicking on one of them will get you to a page where you could have a small description of your project but you won't see any ather links (important ones at least). Try to login to see the differences.