I maintain this and other Home Assistant add-ons in my free time: keeping up with upstream changes, HA changes, and testing on real hardware takes a lot of time (and some money). I use around 5-10 of my >110 addons so regularly I install test machines (and purchase some test services such as vpn) that I don't use myself to troubleshoot and improve the addons

If this add-on saves you time or makes your setup easier, I would be very grateful for your support!

Addon informations

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

⚠️ Migration Notice

This addon is no longer actively maintained.

Recommendation: Please backup your database and migrate to this dedicated addon: https://github.com/jkunczik/home-assistant-omada

The recommended alternative:

Is dedicated to Omada functionality
Is in active development
Should be more stable and feature-complete
Has better community support

About

This addon provided the TP-Link Omada Controller for managing TP-Link Omada networking equipment including access points, switches, and routers through a centralized web interface.

The Omada Controller allows you to:

Manage multiple TP-Link Omada devices
Configure wireless networks and VLANs
Monitor network performance and usage
Set up guest networks and access controls
Manage firmware updates
Generate network reports

Migration Instructions

Backup your current data:
- Access your current Omada Controller
- Export your configuration and settings
- Note down all your network configurations
Install the recommended addon:
- Add the repository: https://github.com/jkunczik/home-assistant-omada
- Install the new Omada addon
- Follow their setup instructions
Import your data:
- Import your backed-up configuration
- Verify all devices are properly connected
- Test your network functionality

Legacy Configuration

If you still need to use this addon temporarily:

Webui can be found at <your-ip>:8088 (HTTP) or <your-ip>:8043 (HTTPS).

Custom Scripts and Environment Variables

This addon supports custom scripts and environment variables through the addon_config mapping:

Custom scripts: See Running Custom Scripts in Addons
Environment variables: Use the add-on env_vars option and see Add Environment Variables to your Addon for details.

Support

For this legacy addon: Create an issue on github

For the recommended replacement: Visit https://github.com/jkunczik/home-assistant-omada