= Installing Trac on OpenBSD =

Trac is in ports now, so simply install the package shipped with the OS as of OpenBSD 4.0: 

{{{
$ export PKG_PATH=ftp://ftp.openbsd.org/pub/OpenBSD/`uname -r`/packages/`uname -m`/
$ sudo pkg_add trac
}}}

This will also install all dependencies. Ports picks python-2.4 instead of python-2.3, and everything appears to work fine.

OpenBSD 4.2 unfortunately has expat in xbase42.tgz and hence requires the installation of the X Server base packages as Trac depends on expat (note: this is fixed in 4.3, as expat is now in base43.tgz). If you did not install xbase42.tgz install set, download it from your favorite mirror and extract them at the root level while preserving permissions: 

{{{
$ sudo tar xzvphf xbase42.tgz -C /
}}}

As of OpenBSD 4.1, Apache httpd 2.2 is also in the ports tree with a package available. If PKG_PATH is already set correctly, simply do:

{{{
$ sudo pkg_add apache-httpd
}}}

pkg_add automatically installs any dependencies.

== Manual Install Not Needed ==

The OpenBSD project tweaks, packages and tests thousands of pieces of
software in the ports tree for every release so you don't have to.
Unless you specifically know why, you should just use packages instead
of compiling from ports or, even worse, try to download tarballs and
compile the programs yourself.

== First-time setup ==

=== Create the Subversion repository ===
{{{
$ svnadmin create /var/svn 
}}}

=== Create the Trac project environment ===
{{{
$ trac-admin /var/trac initenv 
Creating a new Trac environment at /var/trac 

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]> (Your project name)

 Please specify the absolute path to the project Subversion repository. 
 Repository must be local, and trac-admin requires read+write 
 permission to initialize the Trac database. 

Path to repository [/var/svn/test]> /var/svn 

 Please enter location of Trac page templates. 
 Default is the location of the site-wide templates installed with Trac. 

Templates directory [/usr/local/share/trac/templates]> (Just press enter here)
Creating and Initializing Project 
(Output removed)
Don't forget, you also need to copy (or symlink) "trac/cgi-bin/trac.cgi" 
to you web server's /cgi-bin/ directory, and then configure the server. 
cp /usr/local/share/trac/cgi-bin/trac.cgi /usr/local/apache2/cgi-bin 

If you're using Apache, this config example snippet might be helpful: 

    Alias /trac "/var/www/users/trac/htdocs/" 
    <Location "/cgi-bin/trac.cgi"> 
        SetEnv TRAC_ENV "/var/trac" 
    </Location> 
    
$ chmod -R a+rw /var/svn/repo
}}}