NAME

       quasselcore — the daemon process for the Quassel IRC client

SYNPOSIS

       quasselcore [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.

       quasselcore provides the daemon which connects to IRC networks, allowing any number of Quassel clients to
       connect, including the official desktop client, the quasselclient program.

OPTIONS

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

       -c, --configdir=CONFIGDIR
              Specify the directory holding the configuration files, the SQLite database with chat logs  (unless
              another database backend is selected), and the SSL/TLS certificate.

       --config-from-environment
              Load  configuration  from environment variables, ignoring the configuration file.  See the section
              on ENVIRONMENT VARIABLES.

       -d, --debug
              Enable extra debugging output. Requires setting --loglevel=Debug.

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

       -h, --help
              Show help message.

       --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. Default is: ::,0.0.0.0 (all addresses)

       -L, --loglevel=LOGLEVEL
              Set the logging level to LOGLEVEL: Debug, Info, Warning, Error. Default is: Info

       -l, --logfile=LOGFILE
              Log to a file.

       -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 quasselcore will listen at. Default is: 4242

       --require-ssl
              Require SSL for remote (non-loopback) client connections.

       --select-authenticator=AUTHENTICATOR
              Starts an interactive session to switch your current user authentication 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 quasselcore 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 certificate.

       --strict-ident
              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.

       --syslog
              Log to syslog.

       -v, --version
              Display version information.

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 --select-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

       /var/lib/quassel
              Configuration files, the SQLite database with  chat  logs  (unless  another  database  backend  is
              selected), and the SSL/TLS certificate. To override, see --configdir.

       /etc/default/quasselcore
              Additional configuration parameters, including default port and logging level.

NOTES

       In  a  typical  installation, quasselcore runs as the quasselcore user, with configuration data stored in
       /var/lib/quassel.  When manually running quasselcore, you should specify the proper user and  --configdir
       as follows.

           $ sudo --user=quasselcore \
           quasselcore --configdir=/var/lib/quassel [OPTIONS]

AUTHORS

       The full list of Quassel IRC authors and contributors may be seen in quasselclient'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.