Skip to main content

Nodes List

The Nodes tab shows every device your radio has heard on the mesh. Tap any node for details.

Node Status

ElementMeaning
Node circleShort Name & Long Name — each node has a short name (up to 4 bytes) shown in the coloured circle and a long name displayed next to it. The circle colour is derived from the node number. The short name can be an emoji or initials.
OnlineOnline — the node has been heard recently and is considered online.
Idle / SleepingIdle / Sleeping — the node has not been heard from recently and may be asleep or out of range.
Hops AwayHops Away — the number of intermediate nodes relaying messages between you and this node. No hops means direct communication.

Encryption

IconMeaning
Shared KeyShared Key — direct messages are using the shared key for the channel.
Public Key EncryptionPublic Key Encryption — direct messages use public key infrastructure. Requires firmware 2.5+.
PKI MismatchPublic Key Mismatch — public key does not match the previously recorded key. Verify the contact out-of-band.

Device Roles

Each node is configured with a role that determines how it behaves on the mesh. Roles are shown in the node detail view.

IconRoleDescription
ClientStandard end-user device. Sends and receives messages, shares position.
Client MuteLike Client but does not forward packets from other devices. Reduces mesh traffic near congested areas.
Client HiddenOnly broadcasts as needed for stealth or power savings.
Client BaseRooftop node that distributes messages widely from nearby Client Mute nodes.
RouterDedicated infrastructure node — prioritises packet forwarding. Not for rooftops or mobile nodes.
Router LateLike Router but rebroadcasts once after all other nodes. Better suited to rooftop deployments.
TrackerBroadcasts GPS position packets as priority. Optimised for frequent location reporting.
SensorBroadcasts telemetry packets as priority. Optimised for sensor data.
TAKOptimised for ATAK system communication. Reduces routine broadcasts.
TAK TrackerEnables automatic TAK PLI broadcasts. Reduces routine broadcasts.
Lost and FoundBroadcasts location as a message to the default channel to assist with device recovery.

Choosing the Right Device Role →

Complete Node Row Examples

The full node row shows the circle avatar, battery level, encryption status, last-heard time, device role, signal strength, and log indicators all at once.

Directly connected node, favorite, with signal meter Multi-hop node 4 hops away MQTT-bridged node

Compact Node Row Examples

Directly connected node with all telemetry info Multi-hop node 7 hops away Node with position, 1 hop PKI key mismatch node MQTT-bridged node

Context Menu Actions

Long-press any node in the list to access quick actions:

  • Add to favorites / Remove from favorites — star important nodes so they appear at the top of the list
  • Mute notifications / Unmute — silence alerts from this node
  • Message — open a direct message conversation with this node
  • Trace Route — discover the path messages take to reach this node
  • Ignore / Remove from ignored — hide this node from normal views
  • Remove — remove the node from your local database

Additional Icons

Tap a node and scroll to the Logs section for detailed metrics:

LogDescription
Distance & BearingDirection and distance to the node based on GPS. Requires both devices to share location.
Channel badgeThe numbered circle shows which channel the node uses. Only shown for secondary channels (not primary channel 0).
Device MetricsBattery level, voltage, channel utilisation, and airtime reported by the node.
PositionsGPS position data including latitude, longitude, and altitude.
EnvironmentSensor data: temperature, humidity, barometric pressure.
Detection SensorMotion or door open/close alerts from the node.
Trace RoutesRecorded trace route paths showing the hops a message took through the mesh.

Local Stats and Noise Floor

Local Stats show radio diagnostics reported by a node, including packets received, packets transmitted, duplicate packets, relayed packets, bad receives, canceled packets, online node count, total node count, and noise floor.

Noise floor is displayed in dBm when the node reports it. Treat it as a directional diagnostic instead of an absolute site score: readings can vary quickly, and external filters can lower or skew the displayed value because of insertion loss or in-band interference.

Node Detail View

Tap any node to see the full detail view with hardware info, signal metrics, environment sensors, and log navigation:

Node Detail

Hardware Info

The hardware section shows information about the physical device running the node. The section title reflects the device's support status:

StatusMeaning
Supported HardwareDevice is actively supported with firmware updates.
Discontinued HardwareDevice is no longer supported and does not receive firmware updates.

For supported devices, the support tier is shown below the hardware name:

TierDescription
FlagshipRecommended device with full feature support and active development.
NicheSupported device with active firmware updates and a specialised form factor.
LegacyOlder device that still receives firmware updates but may lack some features.

Where to Buy

For devices with known purchase links, an I want one section appears below the hardware info. It shows the official vendor link and regional marketplace options (Amazon, Rokland, AliExpress, and others) sourced from msh.to.

Marketplace links are filtered to your device region, so only stores that ship to your area are shown. Vendor links (directly from the device manufacturer) are always shown regardless of region.

Tip — No purchase links shown Purchase links require an internet connection on first launch and after clearing app data. Connect the app to update the device catalog.

Device Configuration Docs →