Building Quassel core from source on Ubuntu¶

These instructions tell how to build the latest quassel core for your Ubuntu server.
Since it scales better with many users and huge amounts of history, using PostgreSQL database as backend will be explained, too.

Make sure repositores are up-to-date¶

sudo apt-get update

Install required dependencies and build tools¶

sudo apt-get install git-core qt4-dev-tools libqt4-dev libqt4-sql-sqlite screen

Also install the sql driver for your planned backend.

- For sqlite (Quassels default, suggested for single user setups):

sudo apt-get install libqt4-sql-sqlite

- For PostgreSQL (suggested for multiuser setups):

sudo apt-get install libqt4-sql-psql

Get the sources¶

git clone git://git.quassel-irc.org/quassel.git

Build it¶

mkdir quassel/build
cd quassel/build
cmake -DWANT_CORE=1 -DWANT_QTCLIENT=0 -DWANT_MONO=0 ../
make
optional step: make install

Another common option to cmake would be:

-DINSTALL_PREFIX=/path/where/it/should/be/installed

Otherwise /usr/local/ is used as the install prefix.

Optional Step: Use PostgreSQL as backend¶

Setup PostgreSQL database master user¶

• Follow these Ubuntu specific instructions

Setup quassel PostgreSQL database. The database password will be asked later by the Quassel client configuration wizard.¶

sudo -i
sudo -u postgres psql
postgres=# CREATE USER quassel ENCRYPTED PASSWORD 'somepassword';
CREATE ROLE
postgres=# CREATE DATABASE quassel WITH OWNER quassel ENCODING 'UTF8';
CREATE DATABASE

Optional Step: Create SSL certificate:¶

openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout ~/.config/quassel-irc.org/quasselCert.pem -out ~/.config/quassel-irc.org/quasselCert.pem

Running Core¶

Screen is a terminal tool which allwos you to leave terminal sessions running background even when you are logged out.

We run quassel in screen so that core keeps running as long as it is killed or the server is restarted

screen
cd quassel/build
./quasselcore

Now you can shut down your terminal and the quassel core still keeps running.

Later we can reattach to this screen session to check out the quassel core terminal output to see if there has been any problems. Login in and type:

screen -x

Now you should how you left your terminal last time you shut it down.

Starting using it¶

Configuration wizard will guide you through the rest of the setup when you connect to your Quassel core using Quassel client for the first time. Remember to choose PostgreSQL backend instead of SQLite when asked.