jkunczik / home-assistant-omada

Docker image to run TP-Link Omada Controller

Home Assistant Omada Add-On

This add-on brings the Omada Controller directly into Home Assistant running on an 64 bit ARM or a x64 processor.

There exist two Add-On-Versions:

• Omada Stable
• Omada Beta

Omada Stable is created from Omada Beta (both in this repository), as soon as the beta add-on is updated to the latest stable upstream version. Omada Beta should also be fairly stable, because the Add-On is mostly consistent with the already tested docker-omada-cotroller, but might contain some Home-Assistant related inconsistencies or bugs.

Installation

Installing third-party repositories:

1. Go to home assistant -> settings -> addons -> addon store
2. Click the hamburger menu (The three dots in the top right corner)
3. Click repositories
4. At the bottom there should be a space to paste the GitHub link: https://github.com/jkunczik/home-assistant-omada
5. You might have to refresh the page, but it should show up in the addon store under "Home Assistant Omada"

Options

If you would like to use your own SSL certificate configured for Home Assistant with this Omada Add-On, it can be enabled in the configuration options. Set Enable Home Assistant SSL to true, and enter the full path for:

• Certificate file
• Private key

The default paths are compatible with the Letsencrypt Add-On.

Contribution

This add-on is a fork of Matt Bentleys docker-omada-cotroller and jkunczik home-assistant-omada would not have been possible without thier excellent work. Other than in the original docker omada controller, this add-on stores all persistent data in the /data directory, so that it is compatible with Home assistant. This Add-On would not be possible without the effort of other people. Pull requests for version updates or new features are always more than welcome. Special thanks goes to DraTrav for pushing this Add-On forward!

Made with contrib.rocks.

home-assistant-omada's Issues

Is there a plan to port this tool to other platforms?

Hi, I'm running HAOS on x86-64, not on a Raspberry.

So unfortunately it's not possible to install this add-on.

Do you plan to port it to this platform?

Thanks
Ralf

Publish image to Docker Hub

Right now, this addon builds the Docker image on the Home Assistant machine during install.
This works fine, but makes the install process very slow (especially on small devices such as a Pi), and makes backups bigger and impractical.
Would you consider publishing the images on Docker Hub, and referencing them from the addon, instead of building them locally?
Is there anything preventing this? I'm willing to help if needed.
Thanks for your awesome work!

Is there plans to continue?

I'm looking at running this on my HA but noticed it's running an older version that is missing features that I use in the newer version. Just curious if this is planned to be updated or not.

Configure Home Assistent integration

Hi!

I would like to add the Home Assistent integration and connect it to the addon. What host name do I need to use in the config flow?

Upgrading from stable to beta

Hi there.

Thanks for the great work on this integration. I have been using the stable version for a while, but am keen to try the features of the later version of the software controller. What is the process for upgrading from Stable, to Beta? If I install the beta, does it overwrite the stable, or do they both run together (and the stable will need to be disabled)?

Also, will my settings automatically be carried across from stable to beta, or do I need to use the backup/restore function?

Many thanks

Update checking fails

When I try a manual update check, I have following error in the logfile:

05-16-2024 08:19:24.524 INFO [comm-pool-13] [] c.t.s.o.m.c.d(): Checking Device Last Firmware...
05-16-2024 08:19:24.532 INFO [https-jsse-nio-8043-exec-8] [] c.t.s.c.l.a.AbstractReadWriteLockService(): [readWriteLockService]businessId:omadac.id:592f2925c2b66059e916b2c79276972c get writeLock module:manager:upgrade.online.check fail, execute onFail.

resolved

resolved

Addon keeps crashing on Raspberry Pi 4 Model B 2G

Seems similar to issue #10 , both the stable and beta addon keeps crashing on Raspberry Pi 4 Model B 2G.

Addon keeps rebooting (due to failing Docker healthchecks?)

Hi hi!

Thank you so much for putting this together, it makes my life so much easier!

One thing I'm encountering is the add-on keeps rebooting every 5 minutes or so. The web console works fine, but it will still crash regardless. I realized this is likely due to the Docker healthchecker failing. I don't have any details on how to fix this yet, but I wanted to open this up and I'll log my notes as I find things out!

For context, running this in Home Assistant 2023.8.1, OS 10.4 on a Raspberry Pi 4 Model B 2G.

Update Omada version

Thank you for this add-on. I'm testing out the beta release on a micro PC.

What should we be doing to keep the Omada version up to date? Trying to port from a container to HA addon and the versions are different. Beta release of the add-on isn't on the latest and greatest Omada

How to install this Addon in Home Assistant?

Hi @jkunczik, hi @DraTrav,

is there any chance you tell me how i can install your addon in HA? I would love to use it...

Thanks and cheers from Cologne Germany ;-)
Dino

Switching to Stable from Beta

Not an issue, but more just a question. What's the best way to switch to Stable from the Beta? I originally setup the Beta because I'm using an x86 but it appears the Stable now supports it as well. Would I just need to do a backup (or whatever's it's called WITHIN Omada, not an add-on backup) and then restore from that after setting up the Stable add-on?

CPU Load increased up to 80%

Hey,
I installed the Omada Controller in HA and i worked well.
But, bevor i Installed the Omada Controller, the Raspi 4 4GB hat a CPU Load with approx. 2-4%
Now, with running Omada Controller the CPU load is approx. 80%
I guess it isn`t normal the load increase that much?
Greatings Chris

Is it possible to add ingress for the addon for the beta?

The beta version works great on my pc. I'd love for this to work all within HA if possible.