Setup a Mercurial and Trac server

Version 4, last updated by Andy Singleton at May 02, 2011 04:56 UTC

Please write instructions for how to set up a Mercurial and Trac server. It serves Trac and Mercurial with http. It uses an apache module to authenticate users with a web service call to the Assembla/Breakout app server. It runs the Breakout Control Center to create and destroy instances of trac and mercurial.

We will use this as a base for our new Source/hg tool.

From Vitalie -

This guide refers to trac 0.10.6 installation with mercurial 1.0.x. Newer mercurial version does not work with our code and it needs to be fixed. Below configuration works on our production server with Debian 5.0(Lenny).

Installation

You need to add assembla apt repository to your local apt conf to install trac-bk package. Add a file /etc/apt/sources.list.d/assembla.list with below content:

deb http://apt.assembla.com/debian/ sid main

Update the apt cache and install new packages:

apt-get update
apt-get install trac-bk trac-webadmin trac-xmlrpc python-soappy-bk python-memcache
apt-get install breakout-mod-auth apache2-mpm-prefork libapache2-mod-python
apt-get install mercurial breakout-control

Install mercurial plugin for trac from http://trac-hacks.org.

Configuration

Apache vhost configuration can be found in this repository: files/apache2/*

Add to /etc/breakout-control/control.yml below lines:

trac_hg:
  base_dir: /opt/beta/trac
hg:
  base_dir: /opt/beta/hg
  hook: /usr/share/breakout-control/hooks/hg-post-commit-hook.rb

Note	`/opt/beta/{trac,hg}` should be writable by www-data user.

Reload ernie handlers if service is running.

Then you should add a tool server in breakout admin interface. After you can add/remove trac/hg tools.

Assembla Development