mikrotik platform offers presence detection by looking at connected devices to a MikroTik RouterOS based router.
There is currently support for the following device types within Home Assistant:
- Presence Detection
You have to enable accessing the RouterOS API on your router to use this platform.
/ip service set api disabled=no port=8728
Go to IP -> Services -> API and enable it.
Make sure that port 8728 or the port you choose is accessible from your network.
Adding Mikrotik to your Home Assistant instance can be done via the user interface, by taking the following steps:
Browse to your Home Assistant instance.
In the sidebar click on Configuration.
From the configuration menu select: Integrations.
In the bottom right, click on the Add Integration button.
From the list, search and select “Mikrotik”.
Follow the instruction on screen to complete the set up.
After completing, the Mikrotik integration will be immediately available for use.
To use SSL to connect to the API (via
api-ssl instead of
api service) further configuration is required at RouterOS side. You have to upload or generate a certificate and configure
api-ssl service to use it. Here is an example of a self-signed certificate:
/certificate add common-name="Self signed demo certificate for API" days-valid=3650 name="Self signed demo certificate for API" key-usage=digital-signature,key-encipherment,tls-server,key-cert-sign,crl-sign /certificate sign "Self signed demo certificate for API" /ip service set api-ssl certificate="Self signed demo certificate for API" /ip service enable api-ssl
If everything is working fine you can disable the pure
api service in RouterOS:
/ip service disable api
To use this device tracker you need restricted privileges only. To enhance the security of your MikroTik device create a “read only” user who is able to connect to API and perform ping test only:
/user group add name=homeassistant policy=read,api,!local,!telnet,!ssh,!ftp,!reboot,!write,!policy,test,!winbox,!password,!web,!sniff,!sensitive,!romon,!dude,!tikapp /user add group=homeassistant name=homeassistant /user set password="YOUR_PASSWORD" homeassistant
Suggest an edit to this page, or provide/view feedback for this page.