Manage core users » History » Version 24
Version 23 (ragna, 01/19/2019 10:10 PM) → Version 24/25 (psychic, 01/20/2019 01:07 PM)
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 disabling and deleting users, as this is not yet available as a quasselcore switch; bug report and workarounds are provided.
h2. Add a user (Version >= 0.5)
quasselcore provides a command-line option:
* @--add-user@
>Starts an interactive session to add a new core user
h3. Quassel Core permissions and config location (notes for Ubuntu and Debian users)
*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. Change a user's password (Version >= 0.5)
quasselcore provides a command-line option:
* @--change-userpass=[USERNAME]@
>Starts an interactive session to change the password of the user identified by username
Note: please see the quassel core permissions and config location section above!
Example on Ubuntu 18.04.1 LTS with Quassel v0.12.4
Find username for quasselcore service:
ls -lah /var/lib | grep quassel
Should return something like this :
drwxxr-xr-x 2 quasselcore quassel [...] quassel
The user name for the service is quasselcore
Run this command to change the password for user foobar
sudo -u quasselcore quasselcore --configdir=/var/lib/quassel --change-userpass=foobar
h2. Disable a user account
Disabling a user account prevents login, but their backlog and settings are still kept.
Quassel Core does not have a commandline switch to disable a user's account. As a workaround for disabling an account, change their password to an arbitrary long string.
h2. Delete a user account
Disabling a user account prevents login, and their backlog and settings are also removed.
Deletion of users as a @quasselcore --del-user@ switch is not implemented. It is tracked as a feature request:
- https://bugs.quassel-irc.org/issues/909
There is a script [[Delete_Users|to delete users]] directly from the database.
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 disabling and deleting users, as this is not yet available as a quasselcore switch; bug report and workarounds are provided.
h2. Add a user (Version >= 0.5)
quasselcore provides a command-line option:
* @--add-user@
>Starts an interactive session to add a new core user
h3. Quassel Core permissions and config location (notes for Ubuntu and Debian users)
*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. Change a user's password (Version >= 0.5)
quasselcore provides a command-line option:
* @--change-userpass=[USERNAME]@
>Starts an interactive session to change the password of the user identified by username
Note: please see the quassel core permissions and config location section above!
Example on Ubuntu 18.04.1 LTS with Quassel v0.12.4
Find username for quasselcore service:
ls -lah /var/lib | grep quassel
Should return something like this :
drwxxr-xr-x 2 quasselcore quassel [...] quassel
The user name for the service is quasselcore
Run this command to change the password for user foobar
sudo -u quasselcore quasselcore --configdir=/var/lib/quassel --change-userpass=foobar
h2. Disable a user account
Disabling a user account prevents login, but their backlog and settings are still kept.
Quassel Core does not have a commandline switch to disable a user's account. As a workaround for disabling an account, change their password to an arbitrary long string.
h2. Delete a user account
Disabling a user account prevents login, and their backlog and settings are also removed.
Deletion of users as a @quasselcore --del-user@ switch is not implemented. It is tracked as a feature request:
- https://bugs.quassel-irc.org/issues/909
There is a script [[Delete_Users|to delete users]] directly from the database.