# Quassel

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.

## Structure

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

Note: Arch Linux used to have two packages, where quassel-monolighic was part of quassel-client, this was fixed in FS#39756 but if you used to run the monolithic version, you might run into problems after the update. You could try by just installing quassel-monolithic or if that does not help see troubleshooting below.

## Installation

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

## Troubleshooting

If you were previously using quassel-monolithic, your settings might be messed up. Close quasselcore. Move your settings database to a backup copy:

    $ mv ~/.config/quassel-irc.org/quassel-storage.sqlite ~/.config/quassel-irc.org/quassel-storage.sqlite.bak

Then start quasselcore again and connect from your client, you should now get the wizard to show, however, all settings will have to be re-entered.

## See also

- QuasselWiki

Category:

- Internet Relay Chat