Introduction

This page documents custom compiling the latest Bitlbee release, which now supports multi-user-chat support (chat rooms). This document is written as of Jan 3, 2008 based on Bitlbee 1.1.1dev release and Ubuntu 7.10.

Preparation

Dependencies

To install the latest build of Bitlbee we'll need to compile the source code manually. In order to do so we'll need to install a few packages:

sudo aptitude install build-essential libgnutls-dev libglib2.0-dev xinetd

note: the packages (except for xinetd) can be safely removed once bitlbee has been installed successfully

Get the Source

We'll need to download the latest release of Bitlbee which supports MUC (multi-user-chat). As of this writing this version is 1.1.1dev:

wget -c http://get.bitlbee.org/src/bitlbee-1.1.1dev.tar.gz

Unarchive this once it is finished downloading:

tar -xf bitlbee-1.1.1dev.tar.gz
cd bitlbee-1.1.1dev

At this point we're ready to configure the Bitlbee build and compile the code.

If you want to simply configure the default client, which supports the main protocols (AIM/ICQ, MSN, Yahoo! and Jabber) do:

./configure

Personally I only use Jabber, so I don't compile AIM/ICQ, Yahoo! or MSN support. If you'd like to only support Jabber do:

./configure --msn=0 --yahoo=0 --oscar=0

If the configure is done properly you should see output similar to:

Configuration done:
  Debugging disabled.
  Binary stripping enabled.
  Using event handler: glib
  Using SSL library: gnutls
  Building with these storage backends: text xml
  Building with these protocols: msn jabber oscar yahoo

You can now make and install the application. The install-etc option installs some basic documentation. It is optional:

make
sudo make install
sudo make install-etc

Installation Tweaks

Because this isn't a fancy Ubuntu package we need to manually create a few things. To make things work we'll do three more things:

Create the variable data folder

sudo mkdir /var/lib/bitlbee
sudo chown nobody. /var/lib/bitlbee

Create the xinetd configuration

Since we installed xinetd above we also need to configure it for bitlbee:

sudo gedit /etc/xinetd.d/ircd

Add the following content:

service ircd
{
        socket_type = stream
        protocol       = tcp
        wait                = no
        user             = nobody
        server          = /usr/local/sbin/bitlbee
        port              = 6667
        disable         = no
}

Once you've saved this file you'll need to restart xinetd:

sudo /etc/init.d/xinetd restart

At this point you should be able to connect to your new bitlbee server. w00t!