= Installing and Running Trac on Gentoo =

Trac is included in portage as of 2004/04/29.  The current ebuild is marked with ~x86, so you will have to emerge with ACCEPT_KEYWORDS=~x86 set, or include the following in your /etc/portage/package.keywords:

{{{
  www-apps/trac ~x86
}}}

You may need to do the same thing for clearsilver because currently, clearsilver only has ~x86 ebuilds in the main portage tree.  Once that is done, installing is as simple as:

{{{
  emerge trac
}}}

Past that, normal Trac configuration should apply.

Someone's put together a really nice guide to setting up trac on gentoo [http://wiki.dju.elegiac.net/wiki/MultipleTracInstancesOnGentoo here.]

There were a couple of little things that were required to make Trac on Gentoo work.

 * Make sure your berkdb and python use flags are set to 'true'!

 * '''If you have any trouble, go down to the bottom and start emerging components this is how I figured out that the svn bindings for Python weren't building, etc..''' Be sure to run the python update script if needed.

 * Once built, your alias for /trac will be different from the TracInstall doc. It'll look something like this:

{{{
Alias /trac "/var/www/yourdomainhere/htdocs/trac/"
}}}

This makes Trac all pretty, like you're used to seeing! Otherwise it's got essentially no layout.