Connecting your MQTT Broker to TagoIO
TagoIO supports MQTT connections through the MQTT Relay command-line tool. The relay acts as a bridge between your MQTT Broker and the TagoIO platform, enabling seamless integration and reliable data flow. Developed in Rust, the TagoIO MQTT Relay is fast, open‑source, and highly scalable.
What is TagoIO MQTT Relay?
The relay connects to your broker on predefined topics and redirects incoming data to Devices in your Profile using an Authorization Key from your profile settings. It leverages TagoIO’s Integration Network and Connector to process and store the data. In addition to receiving data, the relay can also publish to topics, allowing bi‑directional communication via standard TagoIO tools such as the API and SDK.
Installation
Learn how to use the relay here: tago-io/mqtt-relay: TagoIO | MQTT Relay
How it works
Data Flow
- MQTT Broker Connection – The relay connects to your MQTT broker and subscribes to predefined topics.
- Data Redirection – Incoming data on these topics is forwarded to TagoIO Devices.
- Network Integration – The relay uses the Integration Network and Connector to process the payload.
- Device Identification – A Payload Parser exports a serial that TagoIO uses to store the information in the correct device within your Profile.
Customization
Given the diverse strategies for data transmission, the MQTT Relay supports a broad range of solutions. You can customize how the Device is identified using our Network Integrations. The Payload Parser inside the Network can export a Serial, ensuring the data is stored accurately within your Profile.
Demo video
Key Features
The TagoIO MQTT Relay is equipped with the latest features for hosting and deployment:
- TLS and TLS Certificates Support: Ensures secure communication.
- Docker Support: Simplifies deployment and scaling. Refer to the Docker Hub page for more details.
- Configurable: Can be configured through a .toml file or environment variables.
For detailed setup instructions, visit our GitHub repository.