UniFi User SSH Management

Learn how to make, delete and manage users in UniFi using SSH

Alex Lowe avatar
Written by Alex Lowe
Updated over a week ago

Learn how to make, delete and manage users in UniFi using SSH.

Create a UniFi Super Admin from SSH

You can use our script to create new UniFi Super Admin accounts from SSH. This should only be used if you are locked out of your account. If you're not locked out, you should create Super Admins in UniFi under Settings > Admins.

Log in via SSH, then use wget to download the script from GitHub:

wget https://raw.githubusercontent.com/HostiFi/support-tools/main/lib/unifi/py/create-super-admin.py

Customize -u, -p, and -e inputs to provide the username, password, and email address for the new Super Admin account. Run the script:

python3 create-super-admin.py -u username -p p@ssw0rd!22 -e your@email.com

You can now log in to your UniFi server with the new Super Admin!

Delete a UniFi Super Admin from SSH

You can use our script to delete UniFi Super Admin accounts from SSH.

The normal process for deleting Super Admin accounts is to go to Settings > Admins > Edit and change the role from Super Administrator to Administrator, then delete the Admin from each site on the controller.

On a controller with many sites, this can be time consuming, so we wrote a script to automate the removal process:

Log in via SSH, then use wget to download the script from GitHub:

wget https://raw.githubusercontent.com/HostiFi/support-tools/main/lib/unifi/py/delete-super-admin.py
python3 delete-super-admin.py -u username_or_email_here

Customize the -u input to provide the username of the Super Admin account to be removed. Run the script:

python mongo-delete-unifi-super-admin.py -u username

You can verify that the account has been removed under Settings > Admins inside UniFi.

HostiFi

HostiFi provides hosting for both Ubiquiti and TP-Link software-defined-networking (SDN) applications, with servers for UniFi, UISP and Omada. We also offer professional networking consulting, with HostiFi Pro.

If you run into any issues, send an email to support@hostifi.com or contact us via live chat.

Did this answer your question?