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, mean-
ing 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 run-
ning quasselcore, use the quasselclient client program.
COMMON OPTIONS
-c, --configdir=CONFIGDIR
Specify the directory holding the configuration files, the
SQLite database with chat logs, and the SSL/TLS certificate.
-d, --debug
Enable extra debugging output.
-h, --help
Show help message.
-L, --loglevel=LOGLEVEL
Set the logging level to LOGLEVEL: Debug, Info, Warning, Error.
Default is: Info
-l, --logfile=LOGFILE
Log to a file.
--syslog
Log to syslog.
-v, --version
Display version information.
CLIENT OPTIONS
--debugbufferswitches
Enables debugging for bufferswitches.
--debugmodel
Enables debugging for models.
--hidewindow
Start the client minimized to the system tray.
--icontheme=THEME
Override the system icon theme. 'breeze' is recommended. This
may also be configured in the client settings.
--qss=QSS
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.
--add-user
Starts an interactive session to add a new core user
--change-userpass=USERNAME
Starts an interactive session to change the password of the user
identified by USERNAME.
--config-from-environment
Load configuration from environment variables, ignoring the con-
figuration file. See the section on ENVIRONMENT VARIABLES.
--debug-irc
Enable logging of all raw IRC messages to debug log, including
passwords! In most cases you should also set --loglevel Debug.
--debug-irc-id=DATABASENETWORKID
Limit raw IRC logging to this network ID. Implies --debug-irc.
--ident-daemon
Enable internal ident daemon.
--ident-listen=IDENTLISTEN
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)
--ident-port=IDENTPORT
The port the quasselcore will listen at for ident requests. Only
meaningful with --ident-daemon. Default is: 10113
--listen=LISTEN
The address(es) quasselcore will listen on when --port is speci-
fied. Default is: ::,0.0.0.0 (all addresses)
-n, --norestore
Don't restore last core's state, such as previously connected
networks.
--oidentd
Enable oidentd integration. In most cases you should also enable
--strict-ident.
--oidentd-conffile=OIDENTCONF
Set path to oidentd configuration file.
-p, --port=PORT
The port the internal quasselcore will listen at. If not speci-
fied, the internal core will not accept connections from other
clients.
--require-ssl
Require SSL for remote (non-loopback) client connections.
--select-authenticator=AUTHENTICATOR
Starts an interactive session to switch your current user au-
thentication backend to the new one.
--select-backend=BACKEND
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.
--ssl-cert=SSLCERTFILE
Specify the path to the SSL certificate. Reloaded when quassel-
core is sent a SIGHUP. Default is: CONFIGDIR/quasselCert.pem
--ssl-key=SSLKEYFILE
Specify the path to the SSL key. Reloaded when quasselcore is
sent a SIGHUP. Only needed if not combined with the SSL cer-
tificate.
--strict-ident
Use users' quasselcore username as ident reply. Ignores each
user's configured ident setting. Useful for multi-user quassel-
cores 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.
AUTH_AUTHENTICATOR
Specifies the selected user authentication backend. See --se-
lect-authenticator.
AUTH_LDAP_BASE_DN
Specifies the LDAP authenticator base DN.
AUTH_LDAP_BIND_DN
Specifies the LDAP authenticator bind DN.
AUTH_LDAP_BIND_PASSWORD
Specifies the LDAP authenticator bind password.
AUTH_LDAP_FILTER
Specifies the LDAP authenticator filter.
AUTH_LDAP_HOSTNAME
Specifies the LDAP authenticator connection hostname.
AUTH_LDAP_PORT
Specifies the LDAP authenticator connection port.
AUTH_LDAP_UID_ATTRIBUTE
Specifies the LDAP authenticator UID attribute.
DB_BACKEND
Specifies the selected database backend. See --select-backend.
DB_PGSQL_DATABASE
Specifies the Postgres connection database name.
DB_PGSQL_HOSTNAME
Specifies the Postgres connection hostname.
DB_PGSQL_USERNAME
Specifies the Postgres connection username.
DB_PGSQL_PASSWORD
Specifies the Postgres connection user password.
DB_PGSQL_PORT
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 pub-
lished by the Free Software Foundation.
Quassel IRC Team, Internet. 0.13.1 QUASSEL(1)
Generated by dwww version 1.15 on Sat Jun 29 02:16:24 CEST 2024.