Skip to main content

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
Back to top