UniFi CLI Techniques & Cheat Sheet
Info updated: 14 Dec 2025
Tested environments:
UXG Max / UXG Pro
UDM Pro Max / UCG Fibre
Q: How to SSH into UniFi devices (Gateway/Switch/Access Point):
A: Enable "Device SSH Authenication" in the WebGUI first.
For UniFi Network Application 9.4 and above, the setting is under "UniFi Devices - (Filter Panel) Device Upadtes and Settings - (Side Panel) Device Settings - Device SSH Authenication". For older UNA version, the setting is under "Settings - System - General/Advance - Device SSH Authenication".
- Check Status: info
Example output:
root@UXGPro:~# info
Model: Gateway Pro
Version: 5.0.5.28767
MAC Address: d8:b3:70:3d:f8:11
IP Address: 119.17.158.255
Hostname: UXGPro
Uptime: 340616 seconds
NTP: SynchronizedStatus: Connected (http://unifi:8080/inform)
- Speed Test: ui-speed
4. available on UXGs (including the UXG-Lite), UCGs, (and U7 APs?)
4. Use case 1: ui-speed test - auto speed test using primary WAN and nearby remote test server
5. Example output:
root@UXGPro:~# ui-speed test Provider: [Your ISP] Public IP: XXX.XXX.XXX.XXX Latitude: XXX.XXXX Longitude: XXX.XXXXServers:
Rank Latency Jitter Provider (Server Url) ==== ======= ====== ===================== [1] 7 ms 0 ms XXX (http://XXX:XXXX) [2] 7 ms 0 ms XXX (http://XXX:XXXX) [3] 7 ms 0 ms Ubiquiti (http://XXX:XXXX) [4] 15 ms 0 ms XXX (http://XXX:XXXX)Test:
Direction Speed Duration ========= ===== ======== DOWNLOAD 104.3 Mbps 7s (total data used: 92.1 MB) UPLOAD 38.7 Mbps 6s (total data used: 28.7 MB) Result URL: https://wifiman.com/?result=[UUID]
Use case 2: **ui-speed test -o json --durMin 6 --intf=eth2**
Ref: https://www.youtube.com/watch?v=BF6yPzPur_M
Resource checker/Process checker: htop
bmom -p en0
lspci
ethtool -i eth0
cat /proc/device-tree/model
lscpu
cat /proc/meminfo
ip link
ip addr
ip route
ip -4 a show dev eth1
netstat -rnf inet
ifconfig -v ntun4
dmesg | grep -i rtl (kernal msg)
brctl show
Switch Only
cli
en
config
show interfaces switchport
QoS
tc qdisc show dev eth1
tc class show dev eth1
tc filter show dev eth1
journalctl -f | grep speed
top -d 1
figlet "Title"
cat /etc/debian_version
cat /etc/os-release
tcpdump -i any host [IP Address]
cd /var/log/ulog
ls
tail -f syslogemu.log