MQTT and Mosquitto troubleshooting for Home Assistant

Troubleshooting Updated 2026-05-27

RF-HUB does not connect to MQTT

  • Check that the Mosquitto broker add-on is installed and running (Settings > Add-ons).
  • Verify that the username and password are correct.
  • The default port is 1883 — check if you accidentally entered 8883 without having TLS enabled.

Devices do not appear in Home Assistant

  • Enable Enable MQTT discovery in the MQTT integration settings.
  • Check that discovery_prefix is homeassistant (the default value).

Where can I find logs?

  • Mosquitto add-on log: Settings > Add-ons > Mosquitto broker > Log.
  • Home Assistant main log: Settings > System > Logs.
  • RF-HUB: the web interface shows the latest MQTT status under Settings > Home Assistant.