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 |