Mosquitto MQTT Bridge-Usage and Configuration

The Mosquiito broker (server) can be configured to work as an MQTT bridge.

A bridge lets you connect two MQTT brokers together.

They are generally used for sharing messages between systems.

A common usage is connect edge MQTT brokers to a central or remote MQTT network.

Generally the local edge bridge will only bridge a subset of the local MQTT traffic.

In addition you only need to configure 1 of the brokers to act as the bridge, the other will act as a normal broker.

How it Works

When you configure the mosquitto broker as a bridge it becomes an MQTT client and subscribes and publishes to topics on the other broker and itself depending on the entries in the mosquitto.conf file.

Configuring the Broker

You will need to configure

• The Address and port of the remote broker or brokers. – Address keyword
• A client name. – Connection keyword
• What topics the broker will publish, and which topics it will subscribe to. -topic keyword
• Remapping if needed.

Note: You can configure multiple remote broker addresses and the broker will switch to another broker if the current broker connection fails.

Topic Bridging

What topics are being bridged and if they are being remapped is controlled by the topic entry.

The general format is

topic topic pattern direction QOS local prefix/remote prefix.

Direction can be out,in or both.

e.g.

topic house/sensor1 both 0 “” “”

topic_name=house/sensor1
direction both (could also be in and out)
QOS=0
Local_prefix=none
remote_prefix=none

The entries:
topic house/sensor1 in 0 “” “”
topic house/sensor1 out 0 “” “”

Are equivalent to the single entry:

topic house/sensor1 both 0 “” “”

The screen shot below shows how to bridge all topics with no remapping.

With the above configuration then:

• When a Client connected to broker 1 publishes on any topic that message will be sent to broker 2 . Example incoming message on topic house/sensor1 are published to broker 2 on topic house/sensor1.
• When a client connected to broker 2 publishes a message then messages published on any topic are sent from broker2 to broker 1.

Note: The messages are sent from broker 2 to broker 1 because broker1 subscribed to that topic on broker 2

Topic remapping is accomplished using topic prefixes.

The topic prefixes follow the QOS entry.

The screen shot below shows a remapping configuration for broker 1:

With the above configuration then:

• When a Client publishes on any topic that message will be sent to broker 2 with the topic prefix b2/. Example incoming message on topic house/sensor1 is published to broker 2 on topic b2/house/sensor1.
• When a client publishes a message to broker2 then messages published on b2/# are sent from broker2 to broker 1 but without the b2/ prefix. A message published to broker 2 on house/sensor1 is not sent to broker 2

Broker 2 Configuration

Broker2 is functioning as a normal broker (not a bridge) and doesn’t normally need any extra configuration.

Topic Bridging and Remapping

This is accomplished using the local and remote prefixes.

When the bridge on broker1 subscribes to a topic on broker2 it uses the form

remote_prefix + topic name e.g. b2/house/sensor1

When the bridge on broker1 subscribes to a topic on broker1 it uses the form:

local_prefix + topic name e.g. b1/house/sensor1

The following diagram illustrates the general process.

 

Bridging and Topic Remapping Examples

The following examples refer to the schematic above with two brokers broker1 and broker2 . Broker1 is configured as the bridge.

Normal clients will also be connected to both brokers.

Entry:

topic house/sensor1 both 0 “” “” or

topic house/sensor1 both 0

Also Equivalent to

topic house/sensor1 out 0
topic house/sensor1 in 0

Effect:

Incoming messages from a client connected to broker1 to a topic house/sensor1 are being bridged and will be sent to broker2 on topic house/sensor1.

Incoming messages from a client connected to broker2 on the topic house/sensor1. will be sent to broker1 on topic house/sensor1.

---

Entry uses remote prefix:

topic house/sensor1 both 0 “” b2/

Equivalent to

topic house/sensor1 out 0
topic house/sensor1 in 0 “” b2/

Effect:

Incoming messages from a client connected to broker 1 on the topic house/sensor1 are being bridged and will be remapped and sent to broker2 on topic b2/house/sensor1.

Incoming messages from a client connected to broker2 on topic b2/house/sensor1. will be sent to broker1 on topic b2/house/sensor1..

Broker1 removes the b2 prefix and will send them to clients subscribed to house/sensor1 on broker 1.

---

Entry uses local and remote prefixes:

topic house/sensor1 both 0 b1/ b2/

this is the same as:

topic house/sensor1 out 0 b1/ “”
topic house/sensor1 in 0 “” b2/

Effect:

Incoming messages from a client connected to broker1 on topic b1/house/sensor1 are being bridged and will be remapped and sent to broker2 on the topic b2/house/sensor1.

Incoming messages from a client connected to broker2 on the topic b2/house/sensor1. will be sent to broker1 on topic b2/house/sensor1.

Broker 1 removes the remote prefix (b2/) and then adds the local prefix (b1/) and will send them to clients subscribed to b1/house/sensor1 on broker 1

Working Example

Using the configuration shown above on broker 1 I am going to publish a message to broker 1.

Broker 1 has the bridge configured to connect to broker2 (IP address 192.168.1.157).

The topic bridging entry is:

topic # both 0 “” b2/

Broker 1 accepts messages and publishes them to broker 2 with a prefix of b2/.

Broker 1 subscribes to messages from from broker 2 on topic b2/#

Using a simple python client we will :

• Publish a message to broker1 on topic house/sensor1. Using a client name of P1
• Subscribe to broker2 on topic b2/house/sensor1 -Using client name of P2

When you start the broker on broker 1.

• It connects to broker 2 and subscribes to the topics b2/#.
• Connects to itself and subscribes to topic #

This can be seen from the console log messages:

When I run the script this is what I see.

Broker 1 receives message on topic house/sensor1 and publishes them to broker2 on b2/house/sensor1.

Broker2 receives messages on b2/house/sensor1 from broker1.

Backwards Testing

I can also publish to broker 2 on topic b2/house/sensor1 and it should be sent to broker 1 and made available as house/sensor1.

So now I will alter my script to send to broker 2 on topic b2/house/sensor1 and subscribe to house/sensor1 on broker 1.

Here is a screen shot of the results.

Notice the message is received by the client subscribed to broker 1 n the topic house/sensor1

Topic Remapping and Topic Republishing

Topic remapping takes an incoming topic and renames it.

E.g A broker would receive messages to topic sensor1 and remap them to new_sensor1.

Currently this form of remapping is not available, but prefix remapping is as shown above.

Topic republishing is done using an MQTT client and not a broker.

It can be used for more sophisticated remapping schemes but generates more traffic. See this python code example.

Bridging to Multiple Brokers- Round Robin

It is possible to bridge to another broker in the event of a broker failure.

To do so you need to set multiple address:port entries in the address field i.e

address 192.168.1.168:1883, 192.168.1.185:1883

will use broker 192.168.1.185 if the connection to the first broker (192.168.1.168) fails.

The round robin setting controls what happens when the original connection is restored. Here is the description taken from the online manual:

Authentication and Encryption

If the remote broker requires a username and password then you need to enter this using the remote username and remote password options.

You can also encrypt the connection between the brokers. This is likely to be a common configuration and Is covered in more detail in the Configure Mosquitto Bridge With SSL Encryption- Examples tutorial.

Looping

Publishing and subscribing to the same topic on the broker could result in a loop.

However if you try this you find that a broker detects that another broker sent the message, and doesn’t send the message back to it even though the broker has subscribed to that topic.

This confused me at first as looking through the specs I couldn’t find any reference for broker detection.

I did find this comment from Roger Light on a forum that explains it.

This seems to be triggered by the try private statement in the configuration file. This is what the config file states:

# If try_private is set to true, the bridge will attempt to indicate to the
# remote broker that it is a bridge not an ordinary client. If successful, this
# means that loop detection will be more effective and that retained messages
# will be propagated correctly. Not all brokers support this feature so it may
# be necessary to set try_private to false if your bridge does not connect
# properly.
#try_private true

Bridging to Thingspeak Note

I had a request for help regarding bridge configuration on mosquitto when creating a bridge to thingspeak.

If you need to do this you need the following two entries:

notifications flase
cleansession true

See this forum comment

Problems Encountered

When configuring bridges you may encounter some issues. Here are some of the errors I’ve encountered.

Error message on broker –socket error on client <unknown>disconnecting

Cause – Configuration file error. In my case it was the PSK setting.

Problem – Remapping not working as it should.

Cause -I forgot the QOS entry

Video

If you prefer videos I’ve created a video on Configuring a bridged connection on Mosquitto

Related Articles and Resources:

• Mosquitto.conf documentation
• Connecting the last 100 metres –
• Owntracks -bridging
• Implementing SSL on the mosquitto broker.

Mosquitto Configuration Tutorials

• Installing The Mosquitto broker on Windows and Linux
• Quick Guide to The Mosquitto.conf File With Examples
• MQTT TLS Security – Mosquitto Broker Configuration
• Configuring and Testing MQTT Topic Restrictions
• Mosquitto username and Password Authentication Configuration Guide
• Configuring Logging on Mosquitto