> For the complete documentation index, see [llms.txt](https://help.highlight.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.highlight.net/admin/admin-page/controller-wifi.md).

# Controller WiFi

### Overview

This page explains how to create and edit individual WiFi controllers in Highlight. Once created, Highlight automatically discovers the access points associated with a controller (usually within 30 minutes) and APs can then be moved to a different location from the controller.

After initial discovery, Highlight periodically refreshes the list of APs. Descriptive information (configured into the AP by the Wireless LAN administrator) is collected by Highlight for each AP on discovery and then updated periodically.

For Cisco Meraki and Extreme, use this[ alternative method to create a controller](/admin/admin-page/controller.md).

{% hint style="info" %}
To Create a WiFi Controller: Select a location in Admin and click + then Create WiFi Controller.
{% endhint %}

## Main - Controller details

<table><thead><tr><th width="127">Field</th><th>Details</th></tr></thead><tbody><tr><td><strong>Controller</strong></td><td>Enabled (green toggle) or Disabled (red toggle). When disabled, Highlight stops collecting data. Existing associated APs remain in Highlight but receive no data. New APs are not discovered.</td></tr><tr><td><strong>Name</strong></td><td>Required. Maximum 100 characters.</td></tr><tr><td><strong>Description</strong></td><td>Optional. Maximum 100 characters.</td></tr><tr><td><strong>Reference</strong></td><td>Optional. Maximum 50 characters.</td></tr><tr><td><strong>Alerting</strong></td><td>Unchecked by default. When checked, controller contact failures show blue blips on the Access Point chart’s Availability line. No alerts are sent. The watch status card and heat tile do not change to amber or red.</td></tr><tr><td><strong>Type</strong></td><td>Choose from the drop-down list. Available types depend on enabled controllers. The controller type cannot change after saving.</td></tr></tbody></table>

*Possible list of controller types*

### Aruba AirWave

Contact your Aruba AirWave administrator to obtain these details.

<table><thead><tr><th width="127">Field</th><th>Details</th></tr></thead><tbody><tr><td><strong>Hostname</strong></td><td>Required. The DNS name or IP address of the controller.</td></tr><tr><td><strong>Ignore certificate errors</strong></td><td>Unchecked by default. Checking this option disables all certificate validation. This is a security risk and not advised for production deployments.</td></tr><tr><td><strong>Port</strong></td><td>Required. Set to 443 by default.</td></tr><tr><td><strong>User</strong></td><td>Required. Maximum 100 characters.</td></tr><tr><td><strong>Password</strong></td><td>Optional when initially creating in Highlight, but will be required to connect to the controller. Maximum 100 characters.</td></tr></tbody></table>

### Ruckus

Contact your Ruckus administrator to obtain these details.

{% hint style="info" %}
The Ruckus SmartZone controller must have a valid TLS certificate installed, and it must be assigned to the Management Web service. The certificate authority must be trusted by the machine that the agent is installed on.
{% endhint %}

<table><thead><tr><th width="127">Field</th><th>Details</th></tr></thead><tbody><tr><td><strong>Hostname</strong></td><td>Required. Maximum 255 characters.</td></tr><tr><td><strong>User</strong></td><td>Required. Maximum 100 characters.</td></tr><tr><td><strong>Password</strong></td><td>Required. Maximum 100 characters.</td></tr></tbody></table>

### Ubiquiti

Contact your Ubiquiti administrator to obtain these details.

<table><thead><tr><th width="173">Field</th><th>Details</th></tr></thead><tbody><tr><td><strong>Hostname</strong></td><td>Required. The DNS name or IP address of the controller.</td></tr><tr><td><strong>Ignore certificate errors</strong></td><td>Unchecked by default. Checking this option disables all certificate validation. This is a security risk and not advised for production deployments.</td></tr><tr><td><strong>Port</strong></td><td>Required. Set to 8443 by default.</td></tr><tr><td><strong>User</strong></td><td>Required. Maximum 100 characters. The user must have role set to read-only and "Allow system stats access" under global/site permissions, as a minimum.</td></tr><tr><td><strong>Password</strong></td><td>Required. Maximum 100 characters.</td></tr><tr><td><strong>UniFi site name</strong></td><td>Required. Set to Default if not changed.</td></tr></tbody></table>

{% hint style="info" %}
A UniFi site name can only be entered on the initial creation of a controller. If the controller has been saved, then the site name is fixed. You can, however, delete a controller and recreate it with a different site name.
{% endhint %}

### SNMP v2 (Aruba Instant On and Cisco)

Aruba and Cisco WiFi controllers can be added by this method.

<table><thead><tr><th width="127">Field</th><th>Details</th></tr></thead><tbody><tr><td><strong>Address</strong></td><td>Required. The IP address or host name of the WiFi controller. Maximum 100 characters.</td></tr><tr><td><strong>Community</strong></td><td>Required. The community string can contain any characters except spaces, up to a maximum of 100 characters.</td></tr></tbody></table>

## Access Points

To edit a controller, either click the controller in Admin or click the controller icon from any discovered access point in Admin Browse.

The table on this tab shows a row for each access point (AP) associated with this controller. Sort the table by clicking a column header, which will then turn grey with a white triangle to indicate ascending (▲) or descending (▼) sort order.

Click the cog or anywhere on the row to edit the AP.

<table><thead><tr><th width="131">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name and description</strong></td><td>Shows the auto-generated AP name and, if available, its description.<br><br>Amber items show data but do not collect data.<br>Red items neither show nor collect data.</td></tr><tr><td><strong>Discovered</strong></td><td>Shows the date when Highlight discovered each AP.</td></tr><tr><td><strong>Path</strong></td><td>The path is grey when the AP shares the controller's location. When moved, the path is black and includes a moved icon.</td></tr></tbody></table>

### Alerting Thresholds

Admin users can customise the thresholds which Highlight uses to generate alert emails (if set up) and change the colour of heat tiles. You can define thresholds on a folder or location. Each setting is inherited by everything below that point unless you override it. Each value is labelled with an icon to indicate which alerting metric it affects: Stability, Load, or Health.

See [WiFi Alerting Thresholds](/admin/admin-general-details/alerting-thresholds.md#wifi) for more information.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.highlight.net/admin/admin-page/controller-wifi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
