A nearly live map of Meshtastic nodes seen by the official Meshtastic MQTT server
- Shows all position-reporting nodes heard by Meshtastic's Public MQTT Server
- Includes nodes self-reporting to MQTT or heard by another node reporting to MQTT
- Node data is updated every minute
- Nodes are removed from the map if their position is not updated after 24 hours
- Search for nodes by name or ID
These are general requirements. Refer to the official docs or reach out to the fantastic Meshtastic community for additional support.
- First, make sure you are running a recent firmware version
- Use the default primary channel and encryption key
- Enable "OK to MQTT" in LoRa configuration (signaling you want your messages uplinked via MQTT)
- Enable position reports from your node
- This may mean enabling your node's built-in GPS, sharing your phone's location via the app, or setting a fixed position
- Ensure "Position enabled" is enabled on the primary channel
- Ensure "Precise location" is disabled on the primary channel and the configured precision is no more than 364 m / 1194 ft
- See Restrictions on the Public MQTT Server for details
If your node can be heard by another node already reporting to MQTT, that's it!
- Enable the MQTT module, using all default settings, possibly with a custom root topic
- View nodes around your area on the map to find MQTT topics being used
- Configure your node to connect to wifi or otherwise connect to the internet
- Enable MQTT uplink on your primary channel
- It is not necessary, and not recommended unless you know what you're doing, to enable MQTT downlink
Note, the "Map reporting" option in the MQTT configuration reports additional data about the local node only.
No, and that's a feature. The goal of this map is to provide a reasonably up-to-date, reliable data source for node locations. This is also why nodes are removed if no position reports are heard after 24 hours.
Maybe! Open a GitHub issue and let's discuss it. Pull requests welcome!
Sure! But please pay attention to the license so we can all benefit from your improvements. :)
The included Dockerfile is for building the meshobserv program, which is responsible for connecting to the MQTT server and handling node messages.
Meshtastic nodes use Protocol Buffers to serialize their messages.
The Meshtastic protobuf definitions must be compiled before building meshobserv.
See the scripts directory for helpful build scripts.