Skip to main content

MQTT Settings

note

This is still under development, use at your own risk. Report any bugs you see by creating an issue on the meshtastic/Meshtastic-device repository or comment on our forum.

caution

You may want to change your GPS location sharing settings if you are enabling this. It will broadcast your location over the internet.

Overview#

If your device is connected to WiFi you can enable it to forward messages along to an MQTT server. This allows users on the local mesh to communicate with users on the internet.

Settings#

SettingAcceptable ValuesDefault
mqtt_disabledtrue, falsefalse
mqtt_serverstring""
is_uplink_enabledtrue, falsefalse
is_downlink_enabledtrue, falsefalse

mqtt_disabled#

If a meshtastic node is able to reach the internet it will normally attempt to gateway any channels that are marked as is_uplink_enabled or is_downlink_enabled. But if this flag is set, all MQTT features will be disabled and no servers will be contacted.

mqtt_server#

The server to use for our MQTT global message gateway feature. If not set, the default server will be used

is_uplink_enabled#

This is a channel specific setting. If your channel has this set to true and you are connected to WiFi, the device will forward along messages to whatever MQTT server is specified in mqtt_server.

is_downlink_enabled#

This is a channel specific setting. If your channel has this set to true and you are connected to WiFi, the device will forward along messages from the MQTT server to the mesh from this device.

Details#

Examples#

Set server
meshtastic --set mqtt_server 192.168.123.234
Enable MQTT server to mesh
meshtastic --set is_downlink_enabled True
View raw encoded messages using mosquitto
mosquitto_sub -h 192.168.123.234 -v -t msh/#
note

FIXME some documentation says msh/# , some says mesh/# . As of 1.2.39 the messages are on msh/#