Mikrotik Router

Monitor and control your Mikrotik device from Home Assistant.

Features:

• Interfaces:
  • Enable/disable interfaces
  • Monitor RX/TX traffic per interface
  • Monitor device presence per interface
  • IP, MAC, Link information per interface for connected devices
• Enable/disable NAT rule switches
• Enable/disable Simple Queue switches
• Device tracker for hosts in network
• System sensors (CPU, Memory, HDD)
• Check firmware update
• Execute scripts
• Configurable update interval
• Configurable traffic unit (bps, Kbps, Mbps, B/s, KB/s, MB/s)
• Supports monitoring of multiple mikrotik devices simultaneously
• RX/TX WAN/LAN traffic sensors per hosts from Mikrotik Accounting feature

Integration preview

Setup integration

Setup this integration for your Mikrotik device in Home Assistant via Configuration -> Integrations -> Add -> Mikrotik Router. You can add this integration several times for different devices.

• "Host" - Use hostname or IP
• "Port" - Leave at 0 for defaults
• "Name of the integration" - Friendy name for this router
• "Unit of measurement" - Traffic sensor measurement (bps, Kbps, Mbps, B/s, KB/s, MB/s)
• "Track accounting" - Determines if integration will track per-host throughput. Accounting must be enabled in Mikrotik first

Configuration

• "Show client MAC and IP" - Display connected IP and MAC address for devices connected to ports on router.
• "Scan interval" - Scan/refresh time in seconds. HA needs to be reloaded for scan interval change to be applied.
• "Unit of measurement" - Traffic sensor measurement (bps, Kbps, Mbps, B/s, KB/s, MB/s)

List of detected devices

Accounting

For per-IP throughput tracking Mikrotik's accounting feature is used.

Mikrotik support page

Before setting up integration in HA, go in Winbox IP-Accounting and setup the feature. Make sure that threshold is set to resonable value to store all connections between user defined scan interval. Max value is 8192 so for piece of mind i recommend setting that value. Web Access is not needed, integration is using API access.

Integration will scan DHCP Lease table and ARP table to generate all known hosts and create two sensors for WAN traffic (mikrotik-XXX-wan-rx and mikrotik-XXX-wan-tx). If the parameter account-local-traffic is set in Mikrotik's accounting configuration it will also create two sensors for LAN traffic (mikrotik-XXX-lan-rx and mikrotik-XXX-lan-tx).

Device's name will be determined by first available string this order:

1. DHCP lease comment
2. DNS static entry
3. DHCP hostname
4. Device's IP address