Quassel IRC

h1. Manage core users 

First the existing quasselcore commandline switches to add a user and to change a user's password are discussed. This is followed by a section on deleting users, as this is not yet available as a quasselcore switch; bug report and workarounds are provided.

h2. Versions >= 0.5: add users and change user password

quasselcore provides two command-line 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

*Note for Ubuntu (10.10 and lower) and Debian users*

If you install quasselcore via the default Ubuntu (or Debian) package then your config dir is in '/var/cache/quassel'.  

This means that you need to run quasselcore --add-user with --configdir=/var/cache/quassel and with permissions such that it can access that directory.  Usually this means running it with sudo for Ubuntu or as root for Debian.  So for adding a user the example would be

> <pre> sudo quasselcore --configdir=/var/cache/quassel --add-user </pre>

*Note for Ubuntu 11.04 (and later) Users*

If you install quasselcore via the default Ubuntu 11.04 package the config directory is now in '/var/lib/quassel'.

This means that you need to run quasselcore --add-user with --configdir=/var/lib/quassel and with permissions such that it can access that directory. Usually this means running it with sudo. So for adding a user the example would be

> <pre> sudo quasselcore --configdir=/var/lib/quassel --add-user </pre>

In case this still gives permission issues (recognized by the 'Core is currently not configured!' message), try:

> <pre>sudo -u quasselcore -s</pre> 

followed by 

> <pre>quasselcore -c /var/lib/quassel --add-user</pre>

Similarly, it's necessary to be running as the correct user for password changes.  For Ubuntu (and Debian with the correct path) this works, although you will have to stop a running core first:

> <pre>sudo start-stop-daemon --start --chuid 'quasselcore' --exec 'quasse/usr/bin/quasselcore' --configdir='var/lib/quassel' --change-userpass=$USER_TO_BE_CHANGED</pre>

*Note for openSUSE Users*

If you install quasselcore via the openSUSE package (at least from the KDE:Extra repositories), the config directory is in '/var/lib/quasselcore'.

This means that you need to run quasselcore --add-user with --configdir=/var/lib/quasselcore and with permissions such that it can access that directory. Usually this means running it as root or with sudo. So for adding a user the example would be

> <pre> sudo quasselcore --configdir=/var/lib/quasselcore --add-user </pre>

and for changing an user's password:

> <pre> quasselcore --change-userpass=someusername --configdir=/var/lib/quasselcore </pre>

(run as root)

h2. Delete users

Deletion of users as a quasselcore --del-user switch is tracked as a feature request:

- https://bugs.quassel-irc.org/issues/909

A shell script to delete users is also available. XXX: add link