Quassel Core

From Gentoo Wiki
Jump to: navigation, search

Quassel Core is a daemon/headless IRC client, part of Quassel, that supports 24/7 connectivity. Quassel Client can be attached to it to.

Installation

Emerge

To install:

root #emerge --ask net-irc/quassel

Configuration

Files

OpenRC

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

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=.

FILE /lib64/systemd/system/quasselcore.serviceExample of a default port change
[Unit]
Description=Quassel Core
After=network.target

[Service]
User=quassel
Group=quassel
ExecStart=/usr/bin/quasselcore --configdir=/var/lib/quassel --port=4141

[Install]
WantedBy=multi-user.target

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 )

Services

To start Quassel Core on start-up:

root #rc-update add quasselcore default

Start Quassel Core:

root #/etc/init.d/quasselcore start

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

Troubleshooting

Migrate SQLite to PostgreSQL

Create users in PostgreSQL for Quassel, here we use a user and database called "quassel". See PostgreSQL/QuickStart for information on how to do this.

Then setup Quassel with the user you created:

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.