Overview

NetAlertX comes with MQTT support, allowing you to show all detected devices as devices in Home Assistant. It also supplies a collection of stats, such as number of online devices.

Tip

You can install NetAlertX also as a Home Assistant addon via the alexbelgium/hassio-addons. This is only possible if you run a supervised instance of Home Assistant. If not, you can still run NetAlertX in a separate Docker container and follow this guide to configure MQTT.

⚠ Note

• Please note that discovery takes about ~10s per device.
• Deleting of devices is not handled automatically. Please use MQTT Explorer to delete devices in the broker (Home Assistant), if needed.
• For optimization reasons, the devices are not always fully synchronized. You can delete Plugin objects as described in the MQTT plugin docs to force a full synchronization.

🧭 Guide

💡 This guide was tested only with the Mosquitto MQTT broker

1. Enable Mosquitto MQTT in Home Assistant by following the documentation

2. Configure a user name and password on your broker.

3. Note down the following details that you will need to configure NetAlertX:

   • MQTT host url (usually your Home Assistant IP)
   • MQTT broker port
   • User
   • Password

4. Open the NetAlertX > Settings > MQTT settings group

   • Enable MQTT
   • Fill in the details from above
   • Fill in remaining settings as per description
   • set MQTT_RUN to schedule or on_notification depending on requirements

📷 Screenshots