For adopting a new UniFi AP into the UniFi Controller, we would recommend using our Device Discovery Tool, however there are times when using SSH is required.

If you want fast and reliable UniFi hosting, check out HostiFi with fast support, regular backups, managed updates and prices from just $9 per month.

If you are interested in learning more about our hosting plans, create an account and get started today.

How to adopt a UniFi AP via SSH

First of all, make sure the device is in a factory default state. For information on how to do this, see our guide here.

Next, SSH into the device. This can be via the Terminal application on macOS or via PuTTY on Windows. For more detailed information about how to SSH into a UniFi AP, see our guide here.

Once logged into the UniFi AP, run the set-inform command. Replacing YOURURL with your HostiFi server URL, which can be found in your account, at app.hostifi.com. The format will be mxxxxxx.hostifi.com.

set-inform http://YOURURL:8080/inform

Next, the UniFi AP should show up in your UniFi Controller where you can adopt it. If required, the UniFi AP might automatically upgrade its firmware, so make sure not to remove power to it until it has completed this process.

Troubleshooting

If the UniFi AP hasn't showed up in the UniFi Controller, make sure to check the following:

• Check that you have entered http:// and not https://

• Check that port :8080 has been used and not :8443

• Check all sites on the controller

• The UniFi AP might need a firmware upgrade, as it might be too old. See our guide here for more information on how to do this.

HostiFi

HostiFi provides hosting for Ubiquiti software platforms, with servers for UniFi and UISP. We also offer network consulting, with HostiFi Professional Services.