FAQ. Resetting the password and unlocking the administrator
First, make sure that you are using local authentication and not authentication through an LDAP server. The following instructions apply to local authentication only. If you have LDAP authentication, contact the administrator who manages the LDAP server (or AD).
Starting from version 3.19
User unlock and password reset work exactly the same as for version 3.18.
Reset 2FA binding
Starting from version 3.19, if two-factor authentication is active, you can reset the 2FA binding for a user with the command:
php run credentials/g2fa-reset admin
Starting from version 3.18
Use the instructions for version 3.16 but instead of php userside use php run.
Password reset
php run credentials/password-reset admin
Unlocking
php run credentials/unblock admin
Starting from version 3.16
Starting from version 3.16, a console command is available to manage user accounts:
php userside credentials
By default, the list of users and account lock status is displayed.
The command must be entered while in the userside directory (by default /var/www/userside).
Password reset
To reset the user password, run the command:
php userside credentials/password-reset admin
The password for the account with the username admin will be reset. Command output:
Done! New password for username admin is: dGQl48me34pl7C
Unlocking
To unlock a locked account, run the command:
php userside credentials/unblock admin
Unlocks the account with the username admin if it was locked. Command output:
Done! Username admin was unblocked successfully.
Older versions 3.13...3.15
In versions from 3.13 to 3.15 inclusive, use an SQL query.
The examples below use the database name userside and the account username: admin. Change to yours, if different, before running these queries.
Password reset
Open the psql console and run the query there:
sudo -u postgres psql -d userside UPDATE credentials SET password_hash = '$2y$13$9tw/ZxVyN4TG7nwyzSJjy.qhrtojPibTizH00KEZsBDpLJ7eU5Ob.' WHERE username = 'admin';
After running the command, log in with password 1234 and change it to a secure password.
Unlocking
sudo -u postgres psql -d userside -c "UPDATE credentials SET is_block = false WHERE username = 'admin'"
It's almost ancient, but it's still cool, 3.12
Password reset
sudo -u postgres psql -d userside -c "UPDATE userside3.pbl_oper SET pass = '838787c84ef318aa49d61c0eca871605' WHERE oper = 'Admin'"
Unlocking
sudo -u postgres psql -d userside -c "UPDATE userside3.pbl_oper SET locked = 0 WHERE oper = 'Admin'"
Ancient versions by 3.11
In versions 3.11 and older, credentials are stored in a MySQL database. Queries must be performed for MySQL!
Password reset
mysql -u user_name -p -D userside -e "UPDATE tbl_oper SET PASS = '838787c84ef318aa49d61c0eca871605' WHERE OPER = 'Admin'"
After running the command, log in with password 1234 and change it to a secure password.
Unlocking
mysql -u user_name -p -D userside -e "UPDATE tbl_oper SET LOCKED = 0 WHERE OPER = 'Admin'"