Omada Software Controller - zbrewer/homelab GitHub Wiki

I'm running the TP Link Omada Software Controller (v5) in an LXC in order to administer the Omada devices (wireless APs) on my network.

Installation

The instructions on TP Link's website can generally be followed to install the controller although it should be noted that I used Ubuntu 20.04 in order to provide the easiest path forward. This version supports Java 8 out of the box and makes it easy to install MongoDB 4.4 using the instructions given. More recent releases could be made to work but this was the simplest path forward for me.

Configuration

Email Alerts

After installing the controller and setting up the firewall/reverse proxy as usual in order to access it, follow the prompts in the web interface to perform basic setup. Then, go to Preferences from the Global View (under the overflow menu in the top right) and open the Server Settings page. Enable the SMTP server and set smtp.gmail.com in the SMTP field. SSL and Authentication should also be enabled with 465 for the Port.

The Username and Sender Address should both be the email address of the Gmail account used to send the email and the Password can be an app password generated through the Gmail account specifically for the Omada controller (without spaces). Send a test email and save once this works.

Updates

To update, simply download the latest .deb package from the TP-Link Omada website on the machine running the Omada controller. This can potentially be done through the GUI by selecting Download in response to the update available message. If not, right click on the Download button on the website to copy the URL and then use wget to download it on the server (for example, wget <deb_url>). Then, run dpkg -i <deb_file> to install it over the old version.

⚠️ **GitHub.com Fallback** ⚠️