Ubiquiti UAP device adoption with UniFi network application and SSH terminal
UniFi Device adoption is the process of connecting a UniFi device to a UniFi application in order to be managed by UniFi Controller.
This tutorial explains how Unifi UAP device adoption works, how to adopt devices to the UniFi Network application, and how to troubleshoot any issues that may arise.
The UniFi Network application scans and displays all devices that are unmanaged or managed by UniFi Controller. A UniFi UAP device that is not managed by any application will show a static white LED. This means that the device is available for discovery and adoption.
If the adoption process fails and the UAP device is no longer possible to adopt because the UniFi Controller reject it, for example after a failed provisioning, the first step to do is to remove the device that is no longer connected from the UniFi Controller by clicking on the Forget button.
Manual set-inform via SSH
Now connect over SSH to the device, for example using PuTTY terminal or with Linux use SSH to the Unifi UAP Access Point.
BusyBox v1.25.1 () built-in shell (ash) ___ ___ .__________.__ | | |____ |__\_ ____/__| | | / \| || __) | | (c) 2010-2020 | | | | \ || \ | | Ubiquiti Networks, Inc. |______|___| /__||__/ |__| |_/ https://www.ui.com/ Welcome to UniFi UAP-AC-LR! APBern-BZ.v4.3.28# info Model: UAP-AC-LR Version: 220.127.116.1161 MAC Address: 18:e8:29:c0:b0:d6 IP Address: 192.168.1.20 Hostname: APBern Uptime: 104426 seconds Status: Server Reject (http://192.168.2.17:8080/inform) APBern-BZ.v4.3.28#
If the Unifi UAP status Server Reject is displayed, then you can reset the UAP, using the following command-line from the SSH terminal.
sudo syswrapper.sh restore-default
During the reset, the Unifi UAP will reboot, after about 2 minutes the device is reachable again, possibly now with a different IP address.
The UAP device is now in the status – Pending Adoption (static white LED), the device can now adopt by the UniFi controller application.
Now open an SSH terminal again and execute the command-lines, the command
set-inform must be executed several times. After reset the login is ubnt/ubnt or root/ubnt. The UniFi-Controller is running on Server 192.168.2.17, but it can also by an UniFi Cloud-Key.
set-inform http://192.168.2.17:8080/inform set-inform
After about 2 minutes, the device is ready for adoption, in the UniFi Controller application click Adopt. After another 2 minutes, the device is adopted and has been provisioned. The device status LED now lights up blue permanently.
Advanced UniFi UAP adoption troubleshooting
If the UniFi UAP device doesn’t appear for adoption and the steps above didn’t help, try the following steps:
If the device status LED not lights up, check whether the device is powered. Check the PoE and Ethernet cables. If the device is powered and the LED lights up, it may be managed by another UniFi network application.
If the device status LED is permanently blue, it means that the UAP device has either already been adopted from a UniFi network application and is no longer able to connect, or that the device is managed by another UniFi network application that prevents the device from being detected.
A reset can be triggered on the UniFi device next to the RJ-45 LAN port, use a pen or a curved paper clip to press and hold the reset button for at least 5 seconds, the device status LED starts flashing.
Add additional IP address on Windows
If the device has assigned the IP address 192.168.1.20 and not one from DHCP, it means that the device has been rejected by the UniFi Controller and the provisioning no longer works. In order to be able to reach the device via the SSH terminal, a second IP address must be assigned to the client computer. To do this, proceed as follows under Windows, by pressing the keys, Win+R for Run.
Enter ncpa.cpl and click OK
The Control Panel Network Connections is opened; right-click on Properties above the active network adapter.
Mark the line Internetprotocol Version 4 (TCP/IPv4) and click on Properties.
Enter an IP address in the Alternate Configuration tap, i.e. 192.168.1.2 and the subnet mask 255.255.255.0. Confirm the entry by clicking OK to activate the alternate IP address.
Add second IP address on Linux
Under Linux, a second IP address can be temporarily assigned to the network interface as root.
$ ifconfig eth0:0 192.168.1.2 netmask 255.255.255.0 up
With modern Linux distributions like Debian 10 (buster) or CentOS 7 and newer, it is this command line.
$ ip address add 192.168.1.2/24 dev eth0
macOS use ifconfig to add second IP-Address to interface en0.
$ sudo ifconfig en0 inet 192.168.1.2 netmask 255.255.255.0
The device can now be checked with ping and connected to 192.168.1.20 via SSH terminal.
$ ssh firstname.lastname@example.org
Linux has SSH built in and can be used directly from shell. After the SSH connection to the device has been established, the procedure described above is carried out.
If a UniFi UAP is not accepted after try several attempts Adoption. Assign an alternate IP address to the host on which the UniFi controller is running, i.e. 192.168.1.100. The UAP that does not get an IP from the DHCP can be reached by the UniFi controller in order to be able to initiate provisioning. Cause the UAP can be reached by the controller via the IP address 192.168.1.20, that after execute restore-default. After the successful provisioning, the UAP is back in the original subnet.
It is also possible to use the ADVANCED ADOPT option with click to the + on UAP they appers status MANAGED BY OTHER.