From Gentoo Wiki
(Redirected from Quassel Core)
Jump to:navigation Jump to:search

Quassel is a daemon/headless IRC client, part of Quassel, that supports 24/7 connectivity. Quassel has both a "core" daemon and a client can be used to attached to a running "core" instance.



To install:

root #emerge --ask net-irc/quassel




Gentoo's Quassel package should come with a useful and fairly self-explanatory file to adjust Quassel's default behavior for OpenRC in the /etc/conf.d/quasselcore configuration file.


systemd's variables will need to be set in the /usr/lib64/systemd/system/quasselcore.service file. Options will be the same as those used when running Quassel from the CLI and will need to be added to ExecStart=.

It is not good practice to edit files in the /lib/systemd/system directory. Create a copy in /etc/systemd/system and edit that file. systemd will always source the /etc/systemd/system directory as priority[1] over the same files found in /lib (aka /usr/libhttps://www.freedesktop.org/software/systemd/man/file-hierarchy.html#Persistent%20Variable%20System%20Data).

root #cp /lib/systemd/system/quasselcore.service /etc/portage/system/
FILE /etc/systemd/system/quasselcore.serviceExample of a default port change
Description=Quassel Core

ExecStart=/usr/bin/quasselcore --configdir=/var/lib/quassel --port=4141


SSL/TLS certificate generation

Create an SSL/TLS certificate:

root #( cd /var/lib/quassel/ && openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout quasselCert.key -out quasselCert.crt && cat quasselCert.{key,crt} > quasselCert.pem )




To enable Quassel core on start-up:

root #rc-update add quasselcore default

Start Quassel core:

root #/etc/init.d/quasselcore start


To enable Quassel core on start-up and start the service immediately:

root #systemctl enable --now quasselcore

Client connection

Connect to the core with a Quassel client, and the client will prompt for initial setup configuration, including database credentials. At times it may be necessary to change Quassel's behavior, such as its default listening address, default port, etc.

To change the default port from the CLI:

root #quasselcore --configdir=/var/lib/quassel --port=4141

Other options can be displayed with:

root #quasselcore --help


Migrate SQLite to PostgreSQL

Create users in PostgreSQL for Quassel, here a user and database called "quassel" will be used as an example. See PostgreSQL/QuickStart for information on how to do this.

Then setup Quassel with the newly created user:

root #quasselcore --configdir=/var/lib/quassel --select-backend=PostgreSQL

See also

  • Irssi — a powerful text-mode IRC client for connecting to internet relay chat (IRC) networks.
  • WeeChat — a light, extensible, actively maintained, well documented, highly featured text-mode IRC client.