Mikrotik Router
tomaae/homeassistant-mikrotik_router · vv2.3
Mikrotik router integration for Home Assistant
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…) | |
button | Button (as a switch) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
Local MikroTik RouterOS polling works across many routers and CAPs. RouterOS 7.17 broke setup on models missing system health data, later fixed.
- Works6
- Partly works1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| MikroTik cAP AC | Works Local | Failed to connect on RouterOS 7.17; fixed after reportSaved copyDescribe the issue After the upgrade to firmware 7.17 HA can't connect to the mikrotik router. Re-create the integration not solve the rpoblem. ## Software versions - Home Assistant version: 2025.1.4 - Mikrotik Router integration version: 2.1.4 - Mikrotik Hardware: cAP AC - RouterOS version: 7.17 Excerpt saved from GitHub on 2026-10-23. | Issue #403 · 2025-01 | |
| MikroTik CCR2004 | Works Local | WiFi support added for ROS 7.13+ without a physical radioSaved copyProposed change My CCR2004 has no physical wifi radio, but can manage CAPs through the `wifi` menu. Since ROS 7.13, this is no longer a separate package (only `routeros` is listed under packages). With this PR, we add support for this scenario by disabling capsman and setting the `_wifimodule` to `wifi` if we're running on ROS 7.13 or later. ## Type of change - [x] Bugfix - [ ] New feature - [ ] Code quality improvements to existing code or addition of tests - [ ] Documentation ## Additional information Note: The code Excerpt saved from GitHub on 2026-10-23. | PR #378 · 2024-10 | |
| MikroTik hAP ac3 | Works Local | Failed on 7.17 from missing system health; fixed after reportSaved copyI have the same problem I have two Mikrotiks at home one loads without a problem but the other one does not load error below. 1. Model: RB750Gr3 (FW: 7.17) works OK 2. Model: RBcAPGi-5acD2nD (FW 7.17) does not work log below log: ERROR (SyncWorker_8) [custom_components.mikrotik_router.mikrotikapi] Mikrotik xxx.xxx.x.xxx error while building list for path /system/health : no such command or directory (health), no such command prefix Home Assistant version: 2025.1.4 Excerpt saved from GitHub on 2026-10-23. | Issue #403 · 2025-01 | |
| MikroTik RB750Gr3 | Works Local | Worked on RouterOS 7.17Saved copyI have the same problem I have two Mikrotiks at home one loads without a problem but the other one does not load error below. 1. Model: RB750Gr3 (FW: 7.17) works OK 2. Model: RBcAPGi-5acD2nD (FW 7.17) does not work log below log: ERROR (SyncWorker_8) [custom_components.mikrotik_router.mikrotikapi] Mikrotik xxx.xxx.x.xxx error while building list for path /system/health : no such command or directory (health), no such command prefix Home Assistant version: 2025.1.4 Excerpt saved from GitHub on 2026-10-23. | Issue #403 · 2025-01 | |
| MikroTik RBcAPGi-5acD2nD | Works Local | Failed on RouterOS 7.17; fixed after reportSaved copyI have the same problem I have two Mikrotiks at home one loads without a problem but the other one does not load error below. 1. Model: RB750Gr3 (FW: 7.17) works OK 2. Model: RBcAPGi-5acD2nD (FW 7.17) does not work log below log: ERROR (SyncWorker_8) [custom_components.mikrotik_router.mikrotikapi] Mikrotik xxx.xxx.x.xxx error while building list for path /system/health : no such command or directory (health), no such command prefix Home Assistant version: 2025.1.4 Excerpt saved from GitHub on 2026-10-23. | Issue #403 · 2025-01 | |
| MikroTik RBD53iG-5HacD2HnD | Works Local | Stopped on RouterOS 7.17; fixed after reportSaved copyI have the same problem I have two Mikrotiks at home one loads without a problem but the other one does not load error below. 1. Model: RB750Gr3 (FW: 7.17) works OK 2. Model: RBcAPGi-5acD2nD (FW 7.17) does not work log below log: ERROR (SyncWorker_8) [custom_components.mikrotik_router.mikrotikapi] Mikrotik xxx.xxx.x.xxx error while building list for path /system/health : no such command or directory (health), no such command prefix Home Assistant version: 2025.1.4 Excerpt saved from GitHub on 2026-10-23. | Issue #403 · 2025-01 | |
| MikroTik 951G-2HnD CAP | Partly works Local | Firmware update check showed unknown version on CAP clients without internetSaved copy… version. It should also check if 6.x or 7.x version is running at the moment. ## Screenshots ## Software versions - Home Assistant version: 2022.8.6 - Mikrotik Router integration version: v2.1.1 - Mikrotik Hardware: 951G-2HnD - RouterOS version: 6.49.6 Excerpt saved from GitHub on 2026-10-23. | Issue #240 · 2022-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) | 1,461 (0.21%) |
|---|---|
| GitHub stars | 473 |
| Latest version | v2.3 (2026-09-11) |
| Set up in the UI | Yes |
| Maintainers | @tomaae |
| License | Apache-2.0 |
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 |
|---|---|---|---|
| jnctech/homeassistant-mikrotik_router | ★ 42 | 2026-10-15 | MikroTik RouterOS integration for Home Assistant (HACS). Monitor system health, interfaces, firewall rules, device tracking, DHCP, WireGuard, containers, and more. Supports RouterOS 6 & 7. |
| skrashevich/homeassistant-mikrotik_router | ★ 5 | 2024-07-31 | Mikrotik router integration for Home Assistant. 7.13+ compatible |
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.
