Notice: User passwords can be changed at any time from within Unimus in the "User management" screen.
This article is only required if you lose / forget the password to log-in to Unimus - therefore have no way of accessing the "User management" screen.
The password reset process changed in v. 1.10.4, and as such the reset procedure is different depending on which version of Unimus you run.
Please see the appropriate section of this article depending on your Unimus version.
Version 1.10.4 or newer (current)
In version 1.10.4, we have added a new password reset mechanism.
As such, in 1.10.4 (or newer versions), you should use this method instead of of the one described below.
On the login screen, there is a "Forgot password?" button.
You can press this button if you have lost your password, which will redirect you to the password reset process.
To reset a password, a token will be generated for you, and output in the server log file.
You will need to provide this token to proceed further. Simply follow the instructions on screen to proceed.
After you provide a valid token, you can select which account to reset the password for.
Select an account, and provide a new password. After this is done, you can simply login to Unimus with your new password.
Before version 1.10.4 (legacy)
In versions prior to 1.10.4, you must manually reset the password for the user in the database.
You can generate a BCrypt password hash and insert it into the database for the user you wish to reset the password for.
To generate the password hash, you can any online BCrypt hash generator, or generate the hash yourself.
For example, we have tested with this online hasher: https://bcrypt-generator.com/
In the database, you will find the SYSTEM_ACCOUNT table.
In this table, you will find each user of the system, and you can change the hash in the PASSWORD row for the necessary user.
To check which database your Unimus instance uses, check the configuration files.
Windows:
C:\ProgramData\Unimus\unimus.properties
Linux:
/etc/unimus/unimus.properties
After changing the password hashes in the database, you will be able to log-in to Unimus with the new password that you generated the hash for.
Warining: Do NOT modify any other data in the database, as this will risk corrupting the database integrity.
The above procedure should only be used to regain access to Unimus, in case of total loss of access to the application.
All other user-management tasks (such as changing usernames, deleting users, etc.) MUST be performed from within Unimus.