Ubiquiti EdgeOS Routers
elad-bar/ha-edgeos · vv2.1.9
Integration with EdgeOS (Ubiquiti)
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
select | Mode picker (as switches) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
Monitors Ubiquiti EdgeRouters over the local API; EdgeOS firmware 3.0 broke login for EdgeRouter X users and the fix PR is still open.
- Works1
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Ubiquiti EdgeRouter Lite 3 | Works Local | Interface sensors appear once interface option is enabledSaved copyHi, I don't have any sensor with the last version : I used to have some sensors about wan and lan bandwith. I did reconfigure it, and nothing more. Any ideas ? Regards, Excerpt saved from GitHub on 2026-10-23. | Issue #87 · 2022-11 | |
| Ubiquiti EdgeRouter X (firmware 3.0) | Not working Local | Login fails after firmware 3.0 upgrade; fix PR openSaved copyUpgraded Edgerouter x to firmware version 3.0 and not the integration does not work. Excerpt saved from GitHub on 2026-10-23. | Issue #168 · 2025-08 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 262 (0.04%) |
|---|---|
| GitHub stars | 147 |
| Latest version | v2.1.9 (2025-09-20) |
| Set up in the UI | Yes |
| Maintainers | @elad-bar |
Limitations from the README
- Upgrading to v2.1.x In case the following error appear: ERROR (MainThread) [customcomponents.edgeos] Failed to load EdgeOS, error: , line: 36 Before opening an issue, please try to remove integration from Settings -> Devices & services`, Restart HA and try to add again, if still happen, open an issue and provide log …
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| alvinchen1/ha-edgeos Newer code | ★ 1 | 2026-09-14 | Integration with EdgeOS (Ubiquiti) |
| marosmars/ha-edgeos Newer code | ★ 0 | 2026-10-05 | Integration with EdgeOS (Ubiquiti) |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/elad-bar/ha-edgeos
- Source code: https://github.com/elad-bar/ha-edgeos
- Issues: https://github.com/elad-bar/ha-edgeos/issues
- HACS: https://hacs.xyz