Connecting your MQTT Broker to TagoIO

Connecting your MQTT Broker to TagoIO

TagoIO supports MQTT connections through our MQTT Relay command-line tool. This software acts as a bridge between your MQTT Broker and the TagoIO platform, facilitating seamless integration and data flow. Developed in Rust, the TagoIO MQTT Relay is fast, open-source, and highly scalable.

Learn how to use it here: tago-io/mqtt-relay: TagoIO | MQTT Relay


What is TagoIO MQTT Relay?

The TagoIO MQTT Relay connects to your MQTT Broker on predefined topics and redirects the information to your Devices. It leverages TagoIO's Integration Network and Connector, along with an Authorization Key from your Profile, to ensure secure and efficient data transmission.

The diagram above illustrates the data flow process. The Relay connects to your Broker and listens on a configurable subset of topics, enabling bi-directional communication. This means the Relay can also publish to topics using standard TagoIO tools such as the API and SDK.

How It Works

Data Flow

  1. MQTT Broker Connection: The Relay connects to your MQTT Broker and subscribes to predefined topics.
  2. Data Redirection: Incoming data on these topics is redirected to TagoIO Devices.
  3. TagoIO Network Integration: The Relay utilizes TagoIO's Integration Network and Connector to process and store the data.
  4. Device Identification: A Payload Parser within the Network exports a Serial, which TagoIO uses to store the information in the correct device within your Profile.


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.

Key Features

The TagoIO MQTT Relay is equipped with the latest features for hosting and deployment:
  1. TLS and TLS Certificates Support: Ensures secure communication.
  2. Docker Support: Simplifies deployment and scaling. Refer to the Docker Hub page for more details.
  3. Configurable: Can be configured through a .toml file or environment variables.
For detailed setup instructions, visit our GitHub repository.

    • Related Articles

    • Network Integration

      Your devices can always connect directly with TagoIO API using HTTPS or MQTT protocol. But, you can also connect them using different protocols to databases and web services by using one of this methods: Create a script that initiate access to ...
    • MQTT Retain on TagoIO Broker

      Starting on June 1st, TagoIO will no longer provide MQTT broker to Free accounts. Read more TagoIO's MQTT broker, while not designed to support the native retain feature found in standard MQTT protocol implementations, we offer a workaround to ...
    • Creating a Network integration

      To create a new integration you must go to the Network management page and press the following buttonon the right side of the page. You only need to specify the network's name. Once you have the network created, you have several parameters that you ...
    • MQTT

      Starting on June 1st, TagoIO will no longer provide MQTT broker to Free accounts. Read more MQTT stands for MQ Telemetry Transport; it's an extremely simple and lightweight publish-subscribe messaging protocol. It was designed for constrained devices ...
    • MQTT - Publishing and Subscribing

      Starting on June 1st, TagoIO will no longer provide MQTT broker to Free accounts. Read more You can publish to your MQTT topics by coding a script that will run from an Analysis. When the analysis runs, your script can publish a topic that can be ...