This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.
Please visit our production wiki at https://wiki.gentoo.org
Quassel Core
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=
.
/lib64/systemd/system/quasselcore.service
Example 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