Configuring Unifi APs (UAP-AC-M and UAP-AC-M-PRO)
This guide will walk you through configuring a Ubiquiti Access Point AC Mesh ("bunny ears"), which consists of a few steps:
- Connect the device to your computer, and make sure it has a route to the Internet
- Update the device's firmware to the latest stable version, 4.3.20
- Inform the device of the URL of our Unifi controller
- Adopt the device via the controller interface
You will need
|Unifi Access Point||Unit to be configured|
|Power-over-Ethernet injector (comes with AP)||Supplies power to the AP|
|2 Ethernet cables||One powers AP, one provides data link to computer|
|USB Ethernet adapter||If your computer doesn't have an Ethernet port|
|Computer running MacOS or Linux||Perform remote configuration|
|Paperclip (or other thin item)||Performing a factory reset|
Power the device
- Plug the PoE injector into an outlet, or power strip.
- Connect the
POEport of the injector to the AP Mesh Unit with an ethernet cable. You should see a white light turn on.
The light will be blue if the device has an existing configuration. Don't worry, we'll factory reset the device next.
The AP Mesh Units have had unexpected behavior even out of the box, so it is recommended to factory reset it before continuing.
- With the paperclip, press the reset button at the bottom of the AP Mesh Unit in until it clicks.
- Hold it pressed in for 5 seconds.
- The status light on the AP should flash, then go out as the device reboots. When it comes back on it should be solid white, indicating the reset was successful.
1. Connect the AP to your computer
We need to connect the device to our computer and determine its IP address, while also making sure it also has a route to the Internet. The Unifi mesh aps should automatically reset to
192.168.1.20 so you can first try Step 2 and see if the ssh command works.
If the mesh AP's IP address isn't
192.168.1.20, there are two ways to find the IP address: a) connect to local router b) connect to your computer. We usually do option b) connect the AP directly to our computer.
a) If you have physical access to your WiFi router
- Plug the
LANport of the PoE injector directly into an Ethernet port on your router.
- The AP will get the IP address
192.168.1.20from your router. Skip to the SSH step.
b) If you don't have access to your router
- Connect the
LANport of the injector to your computer, using the USB Ethernet adapter if you don't have an Ethernet port.
- Make sure your computer is connected to WiFi.
- Follow the directions on Sharing a WiFi connection over Ethernet to share your computer's wireless connection with the AP.
- Follow the instructions here: Setting a static IP for your computer to set your
2. Connect to the AP using SSH
- At the terminal, run the command
ssh firstname.lastname@example.org replace the default IP address with the one you copied.
- You may see "
The authenticity of host [...] can't be established". Type "yes" and press Enter.
- When prompted for the password, enter
- You should now be connected to the AP Mesh Unit.
If you you get a
Host key verification failed error, you'll need to edit your
nano, or the text editor of your choice.
2. Remove the line beginning with
192.168.1.20 (It will look something like
192.168.1.20 ssh-rsa AAAAB3NzaC1yc2E...), and save the file.
Set the device firmware version
We use device firmware version 4.3.20, on the advice of the good people at NYCMesh.
- While connected to the device via SSH, type
- You will be disconnected from the device. Wait until it reboots and the light is solid white (you can
pingthe IP address to test if it's up, or just try SSHing), then SSH back in.
- If it hangs, try canceling out and re-running the command
- You can verify the firmware upgrade by looking at the header to your command line input, which provides the firmware version like "UBNT-BZ.v4.3.20#".
If the firmware upgrade hangs forever, skip this step. The firmware can also be upgraded through Hostifi after the AP is adopted.
Adopt AP Mesh Unit
You will need access to the PCW Unifi controller interface to complete this step.
- From your
sshshell, run the command
set-inform http://unifi.phillycommunitywireless.org:8080/inform. This will send a message over the internet to our controller, letting it know the device wants to be adopted.
If your prompt hangs here, your AP probably doesn't have a route to the internet. Return to the connection step and make sure your setup follows those instructions.
- Open the Hostifi portal in your browser, and navigate to the device list. The AP should appear in the list of devices awaiting adoption.
Adoptto adopt the AP Mesh Unit.
- Adoption can take a while. Try refreshing the Hostifi portal and/or browser.
- If it doesn't work, try the set inform command again.
- To upgrade firmware from within Hostifi, go to the device and open the Settings. Under Manage, find the Location URL field, and paste the link for the firmware version (https://dl.ui.com/unifi/firmware/U7PG2/18.104.22.16898/BZ.qca956x.v22.214.171.12498.200704.1347.bin), then press Update.
Computer doesn't recognize AP Mesh Unit in Network settings, or
ssh command fails.
The AP Mesh Unit can take a few minutes to boot after being plugged in, so wait until the status light is solid white and try again.
See our separate doc for more info on related problems: Sharing a WiFi connection over Ethernet
What does this status light pattern mean?
Refer to this article: LED Color Patterns for UniFi Devices