Configure a Ranger to Connect to custom MQTT Broker

This article will describe how to configure a Ranger to connect to a custom MQTT broker using the Ranger ToolKit Software


Step 1: In the Ranger ToolKit Software and enable MQTT and Sparkplug configuration

  • In the Ranger ToolKit go to the Tools menu and select Options
  • On the Options tab in the advanced section enable the MQTT Tab and the Sparkplug Tab and click OK


Step 2: Connect to a Ranger using the micro-USB connector


Step 3: Configure your MQTT Broker on the MQTT Tab

  • Select Custom Cloud Service
  • Enter your broker information and login credentials 
  • Configure the TLS settings to match your MQTT Broker configuration
  • If you are using TLS certificates, you can click the Manage TLS Certificates and load your certificate files into the Ranger

Step 4: Configure your Sparkplug settings

  • Configure your Sparkplug Group ID
  • Configure the Ranger Edge Node ID - note this must be unique!
  • we recommend that your system is configured such that Primary Hose must be online to publish to avoid possible lost data, see the Sparkplug specification for additional details