Ubiquity

Manually Adopt Ubiquity Access Point
SSH to the Access point and login with the default credentials of ubnt / ubnt . 

 Type the following command where 192.168.xxx.xxx is the IP of your Unifi controller: 

 

 set-inform http://192.168.xxx.xxxx:8080/inform 

 

 Login to the Unifi controller and navigate to Unifi Devices. 

 Locate the access point and click Adopt. 

 

 Unifi SSH Commands 

 We are going to start with the most commonly used Unifi SSH Commands, later on, I will organize them by device or function. 

 

 

 

 

 Command 

 Example 

 Function 

 

 

 

 

 info 

 info 

 Displays device information 

 

 

 set-default 

 set-default 

 Factory reset device 

 

 

 set-inform 

 set-inform http://192.168.1.1:8080/inform 

 Set URL of the controller for adoption.  More info 

 

 

 upgrade 

 upgrade https://<firmware-url>.bin 

 Upgrade firmware –  More info 

 

 

 fwupdate 

 fwupdate --url https://<firmware-url>.bin 

 Update firmware 

 

 

 reboot 

 reboot 

 Reboot the device 

 

 

 poweroff 

 poweroff 

 Shutdown device 

 

 

 uptime 

 uptime 

 Shows device uptime 

 

 

 

 

 

 Network related SSH Commands 

 The following Unifi SSh Commands can really help you with finding network-related issues with your Unifi Device. 

 

 

 

 

 

 

 

 Command 

 Example 

 Function 

 

 

 

 

 ifconfig 

 ifconfig 

 Show network interface information 

 

 

 ip address add 

 ip address add 192.168.1.143/24 dev br0 

 Set static IP Address 

 

 

 ip route 

 ip route 

 Display current gateway 

 

 

 ip router add 

 ip route add default via 192.168.1.1 

 Set default gateway 

 

 

 

 echo "nameserver 192.168.1.1" > /etc/resolv.conf 

 Set DNS Server 

 

 

 ping 

 ping 1.1.1.1 

 Check network connection to device 

 

 

 arp 

 arp -a 

 Show arp table 

 

 

 ip neigh 

 ip neigh 

 Show IPv6 neighbors 

 

 

 

 

 

 

 

 Unifi OS SSH Commands 

 When you connect to your UDM Pro (or another controller that is running Unifi OS), then you will have a couple of other options: 

 

 

 

 

 

 

 Command 

 Example 

 Function 

 

 

 

 

 ubnt-systool help 

 ubnt-systool help 

 Show all commands 

 

 

 ubnt-systool cputemp 

 ubnt-systool cputemp 

 Show CPU Temp 

 

 

 ubnt-systool cpuload 

 ubnt-systool cpuload 

 Show CPU load 

 

 

 ubnt-systool portstatus 

 ubnt-systool portstatus 

 Show port status 

 

 

 ubnt-systool hostname 

 ubnt-systool hostname <newname> 

 Set new hostname 

 

 

 ubnt-systool reboot 

 ubnt-systool reboot 

 Reboot device 

 

 

 ubnt-systool poweroff 

 ubnt-systool poweroff 

 Shutdown device 

 

 

 ubnt-systool reset2defaults 

 ubnt-systool reset2defaults 

 Factory reset device 

 

 

 ubnt-device-info summary 

 ubnt-device-info summary 

 Show system information 

 

 

 ubnt-tools ubnt-discover 

 ubnt-tools ubnt-discover 

 Show Unifi devices in the network 

 

 

 cat /mnt/data/udapi-config/dnsmasq.lease 

 cat /mnt/data/udapi-config/dnsmasq.lease 

 Show DHCP Leases 

 

 

 cat /mnt/data/udapi-config/unifi 

 cat /mnt/data/udapi-config/unifi 

 Show configuration 

 

 

 /etc/init.d/S95unifios restart 

 /etc/init.d/S95unifios restart 

 Restart Unifi OS Web interface 

 

 

 

 

 

 

 Unifi Log files 

 There are a lot of log files that you can access to help you debug any Unifi related problem: 

 

 

 

 

 

 Command 

 Function 

 

 

 

 

 cat /var/log/messages 

 Output the error log 

 

 

 tail -f /var/log/messages 

 Monitor log file 

 

 

 cat /mnt/data/unifi-os/unifi-core/config/settings.yaml 

 Server settings 

 

 

 cat /mnt/data/unifi-os/unifi-core/logs/discovery.log 

 Discovery log 

 

 

 cat /mnt/data/unifi-os/unifi-core/logs/system.log 

 System log 

 

 

 cat /mnt/data/unifi-os/unifi/logs/server.log 

 Server log 

 

 

 cat /mnt/data/unifi-os/unifi-core/logs/errors.log 

 Http errors