UniFi OS Consoles Wi-Fi Switching Camera Security Phone System Door Access Accessories UISP

UniFi Video is an obsolete product line.

This application and its related devices will no longer receive any manner of technical support, including functional and security updates. Additionally, there will be no further updates to Help Center content pertaining to UniFi Video.

UISP - Password Recovery


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

Password recovery

Back to Top

ATTENTION: In order for this CLI command to work properly, it is necessary to have docker-compose 1.23.2+ installed. It is possible to check the current docker-compose version with this command:
sudo docker-compose version
In case the docker-compose version is lower than 1.23.2 it is necessary to upgrade it. It is possible to use this command to do it (it may not work if docker-compose was not installed via UISP installation script).
sudo curl -sL "https://github.com/docker/compose/releases/download/1.23.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

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>

When it is necessary to set super admin from outside of UISP 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.

Related Articles

Back to Top

UISP - How to Find Logs and Report Bugs

Was this article helpful?
42 out of 249 found this helpful