UNMS - Password Recovery


Overview


This short guide describes how to retrieve a list of all the UNMS login names and how to perform password recovery when needed. This method should be used when email password recovery is not possible.


Password recovery (0.14.0+)


Back to Top

In version 0.14.0 we changed the password recovery to have the same format as the rest of UNMS CLI commands. To change a user's password, specify the username as a parameter and enter a new password when asked:

sudo ~unms/app/unms-cli set-password --username <username>

In case of any issues with two-factor authentication this command can be used to completely disable it:

sudo ~unms/app/unms-cli disable-two-factor --username <username>

Another new feature is the role of the super admin. When it is necessary to set super admin from outside of UNMS GUI, this command is available

sudo ~unms/app/unms-cli set-superadmin --username <username>
NOTE: It is possible to use all of the commands above without the --username tag, to display the list of users instead of changing their password or disabling 2FA for them.

Password recovery (0.10.0 - 0.13.3)


Back to Top

UNMS includes a script that can be used to change an existing user's password in case of password recovery be e-mail is unavailable. To see the list of existing users in UNMS, run the following command on the UNMS host machine:

sudo docker exec -ti unms ./setpwd.sh

To change a user's password, specify the username as a parameter and enter a new password when asked:

sudo docker exec -ti unms ./setpwd.sh <username>
NOTE: Changing the password this way turns off two-factor authentication. You can turn it on again after logging in.

Related Articles


Back to Top

UNMS - How to Find Logs and Report Bugs


We're sorry to hear that!