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".

  1. 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: Synchronized

Status: Connected (http://unifi:8080/inform)

  1. 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.XXXX

Servers:

  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