May 17, 2020 - Patrick Kerwood

Ubiquiti UAP commands

Every once in a while I need to troubleshoot Ubiquiti UAP's. And since I rarely do so, I forget howto. This post is just a couple of commands for my own deteriorating memory.

# Enable SSH on the UAP's

First step is to enable SSH on the UAP's. I believe it is disabled by default. Go to your Unifi controller Settings.

# Old settings UI

Under the menu Site, you will have to enable Advanced Features. Check the box and press "Apply Changes"

A new configuration box will appear at the bottom of the screen, where you can enable SSH.

# New settings UI

In the search box, just type ind ssh and select "Enable/Disable SSH Auth.." This will take you to the settings where you can enable SSH.

# Get UAP information.

The command info will surprisingly give you information about the UAP, including the inform address and if it's connected to the controller.

UBNT-BZ.v4.3.13# info

Model:       UAP-AC-LR
MAC Address: fc:ec:da:8c:46:06
IP Address:
Hostname:    UBNT
Uptime:      1044 seconds

Status:      Connected (

# Getting device logs

tail -f /var/log/messages

# Reset UAP to default configuration restore-default

# Set Inform address

If your UAP is on another L2 network than the controller, you will have to set the inform address manually. This can be done with below command.

set-inform http://ip-of-controller:8080/inform

By default, if an UAP has not joined the controller yet, the username and password would both be ubnt. After entering the command, the device will pending adaption on the controller.

# Setting the Inform address with DHCP

If you have a lot of UAP's in your environment, the easiest way of setting the Inform address is with a DHCP server. By setting the DHCP option 43, the UAP will take that setting (IP) and use that for the inform address and UAP will magically appear on the controller.

Note that you are not able to set the controller communication port, so your controller has to use 8080 for that.

Here's a couple of exampels i swooped from this UBNT article (opens new window). I use the Miktorik option and it works flawlessly.

The HEX string works as follows.

  • IP:
    • Suboption: 01 (do not change)
    • Length of payload: 04 (do not change)
    • 192: C0
    • 168: A8
    • 3: 03
    • 10: 0A
      • Result: 0104C0A8030A

# Mikrotik

/ip dhcp-server option add code=43 name=unifi value=0x0104C0A8030A
/ip dhcp-server network set 0 dhcp-option=unifi

# Why 0104C0A8030A ?
# 01: suboption
# 04: length of the payload (must be 4)
# C0A8030A:


# ...
option space ubnt;
option ubnt.unifi-address code 1 = ip-address;

class "ubnt" {
  match if substring (option vendor-class-identifier, 0, 4) = "ubnt";
  option vendor-class-identifier "ubnt";
  vendor-option-space ubnt;

subnet netmask {
  option ubnt.unifi-address;  ### UniFi Controller IP ###
  option routers;
  option broadcast-address;
  option domain-name-servers,;
  # ...

# Cisco CLI

# assuming your UniFi is at
ip dhcp pool <pool name>
network <ip network> <netmask>
default-router <default-router IP address>
dns-server <dns server IP address>
option 43 hex 0104C0A8030A # -> CO A8 03 0A

# Why 0104C0A8030A ?
# 01: suboption
# 04: length of the payload (must be 4)
# C0A8030A:

Found a bug? Help me improve this page!
Last Commit: