Scroll to navigation

QUASSEL(1) QUASSEL(1)

NAME

quassel — a modern, cross-platform and distributed IRC client

SYNPOSIS

quassel [OPTION]...

DESCRIPTION

Quassel IRC is a modern, cross-platform, distributed IRC client, meaning that one (or multiple) client(s) can attach to and detach from a central core -- much like the popular combination of screen and a text-based IRC client such as WeeChat, but graphical.

quassel provides a standalone IRC client experience, integrating the core and client into a single program. To connect to and manage a running quasselcore, use the quasselclient client program.

COMMON OPTIONS

Specify the directory holding the configuration files, the SQLite database with chat logs, and the SSL/TLS certificate.
Enable extra debugging output.
Show help message.
Set the logging level to LOGLEVEL: Debug, Info, Warning, Error. Default is: Info
Log to a file.
Log to syslog.
Display version information.

CLIENT OPTIONS

Enables debugging for bufferswitches.
Enables debugging for models.
Start the client minimized to the system tray.
Override the system icon theme. 'breeze' is recommended. This may also be configured in the client settings.
Load a custom application stylesheet.

INTERNAL CORE OPTIONS

NOTE: These options should not need modified in most cases. Running a separate quasselcore is the recommended way to allow multiple clients to connect to a core.

Starts an interactive session to add a new core user
Starts an interactive session to change the password of the user identified by USERNAME.
Load configuration from environment variables, ignoring the configuration file. See the section on ENVIRONMENT VARIABLES.
Enable logging of all raw IRC messages to debug log, including passwords! In most cases you should also set --loglevel Debug.
Limit raw IRC logging to this network ID. Implies --debug-irc.
Enable internal ident daemon.
The address(es) quasselcore will listen on for ident requests. Same format as --listen. Only meaningful with --ident-daemon. Default is: ::1,127.0.0.1 (only localhost)
The port the quasselcore will listen at for ident requests. Only meaningful with --ident-daemon. Default is: 10113
The address(es) quasselcore will listen on when --port is specified. Default is: ::,0.0.0.0 (all addresses)
Don't restore last core's state, such as previously connected networks.
Enable oidentd integration. In most cases you should also enable --strict-ident.
Set path to oidentd configuration file.
The port the internal quasselcore will listen at. If not specified, the internal core will not accept connections from other clients.
Require SSL for remote (non-loopback) client connections.
Starts an interactive session to switch your current user authentication backend to the new one.
Starts an interactive session to switch your current storage backend to the new one. Attempts a merge if the new backend is uninitialized and the old backend supports migration, otherwise prompts for new user credentials.
Specify the path to the SSL certificate. Reloaded when quasselcore is sent a SIGHUP. Default is: CONFIGDIR/quasselCert.pem
Specify the path to the SSL key. Reloaded when quasselcore is sent a SIGHUP. Only needed if not combined with the SSL certificate.
Use users' quasselcore username as ident reply. Ignores each user's configured ident setting. Useful for multi-user quasselcores connecting to IRC networks that require a fixed identifier for each user.

ENVIRONMENT

When --config-from-environment is specified, the quasselcore will use the following environment variables instead of the configuration file. This may be useful for container setups or automated deployment.

Specifies the selected user authentication backend. See --select-authenticator.
Specifies the LDAP authenticator base DN.
Specifies the LDAP authenticator bind DN.
Specifies the LDAP authenticator bind password.
Specifies the LDAP authenticator filter.
Specifies the LDAP authenticator connection hostname.
Specifies the LDAP authenticator connection port.
Specifies the LDAP authenticator UID attribute.
Specifies the selected database backend. See --select-backend.
Specifies the Postgres connection database name.
Specifies the Postgres connection hostname.
Specifies the Postgres connection username.
Specifies the Postgres connection user password.
Specifies the Postgres connection port.

FILES

$HOME/.config/quassel-irc.org
Configuration files, SQLite database with chat logs, and the SSL/TLS certificate. To override, see --configdir.

AUTHORS

The full list of Quassel IRC authors and contributors may be seen in the client's About window.

This manual page was written by Thomas Mueller <thomas.mueller@tmit.eu> and updated by Shane Synan <digitalcircuit36939+deb@gmail.com>, for the Debian GNU/Linux system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License version 2 or any later version published by the Free Software Foundation.

0.13.1 Quassel IRC Team, Internet.