From ArchWiki
Jump to: navigation, search

Quassel (sometimes referred to as Quassel IRC) is a cross-platform IRC client introduced in 2008. It is dual-licensed under GPLv2 and GPLv3, while most graphical data is licensed under the LGPL and provided by the Oxygen Team. The client part of Quassel uses the Qt framework for its user interface.


Quassel is split up into two parts by a server-client model; a client and a core. There is also a monolithic version of the official client that does not require a core. The core(server) is the application that actually does the communication with IRC networks, while the client(s) only communicates with the core. This gives the user a flexibility of having the same instance to IRC networks on different clients (e.g. mobile, desktop at the same time).


Basic usage

Just install the quassel-monolithic package if you only want to use Quassel from a single computer.

Setting up multiple clients to connect through the same core

Install quassel-core and quassel-client.

Generate a certificate (this will be valid for 1 years, after which it needs to be reissued, just change the -days to another value if you so desire):

# openssl req -x509 -nodes -days 365 -newkey rsa:4096 -keyout /var/lib/quassel/quasselCert.pem -out /var/lib/quassel/quasselCert.pem

As this is a self-signed certificate, you can type whatever you want in the fields.

Open port 4242 in your firewall.

Start core by starting quassel.service.

Start the client and connect to core:

$ quasselclient

Accept your self-created certificate.

Now set up your IRC-servers and IRC-nicknames on the core.

Note: As this is the first time you connected to the core, you should see a wizard where you can set up the first user-account. If you do not get this wizard, your settings might be messed up, see troubleshooting below.

Once it all works, you can enable quassel.service to start automatically on system boot.

Adding users

If you want additional users to be able to use the same core, run this command to create them:

$ sudo -u quassel quasselcore --configdir=/var/lib/quassel --add-user

It will then prompt you for a new account's username and password.

See also