The MQTT Import Integration allows connecting to an MQTT broker (MQTT is a lightweight IoT messaging protocol) to receive device status updates or control devices exposed over this interface. In some sense, this integration is similar to MQTT Export integration but in the other direction, i.e., when the "real" device (where state is coming from or commands going to) exists outside your Hubitat hub.
NOTE: The MQTT Import Integration app is currently in beta. As such, you may encounter occasional bugs, breaking changes, features that temporarily differ from documentation, or other issues. If you wish to provide feedback, we suggest visiting the Community forum.
¶ Installation
To install:
- From the sidebar of your hub, navigate to Integrations and select Add Integration or Add Built-In Integration:
- Select MQTT Import Integration from the list.
To enable, select the Enable link at the top of the MQTT Import Integration app. If you no longer wish to use the app, it can be disabled using a similar link at the top of the app (your settings will be preserved if re-enabled later) or removed (which will also erase all settings besides removing the app).
¶ Configuration
To use the MQTT Export integration:
- Decide whether you want to use an external MQTT broker (recommended) or enable the built-in MQTT broker that will run on your hub.
- Select Add connection to add your first (or only) connection to an external MQTT broker, then provide the requested information:
- Connection name: name of your choice (the integration supports multiple connections; this name is for your reference)
- Broker host: the host (e.g., 192.168.1.5)
- Broker port: the port (often 1883 for plain or 8883 for SSL/TLS)
- MQTT username and MQTT password: Provide if necessary for your MQTT broker
- Select Add connection when all fields are filled out correctly, then select Save settings and reconnect if you are finished, or repeat to add additional brokers and then save.
- If you prefer to use the internal MQTT broker, enable the Use built-in MQTT service option. The integration will be automatically configured to use the built-in broker if it is enabled, although you can also use Add connection to add additional brokers, as described above, if needed. The built-in broker will also be accessible on your network for other uses at the provided IP address and credentials. (Keep in mind that the built-in broker will also be restarted when your hub reboots.)
- Select Add connection to add your first (or only) connection to an external MQTT broker, then provide the requested information:
- To map MQTT data to a device on Hubitat, select the Map a device link under the broker from which the device data comes.