meshroom

MQTT augmentation listen to the observer network as well as the radio

MQTT augmentation

ACK ingestion — determine delivery via observers

Message ingestion — capture room posts via observers

Topology ingestion — collect route, SNR, and path reliability data for known infrastructure

Advert ingestion — discover users and their locations

Activity monitor — packets from an inactive member resume sync (at most every 15 min)

Subscriber username Subscriber password

Broker host Port Transport WebSocket path

TLS Verify TLS certificateTopic filter(s)

RF will always be used for fallback and route calculations: what the observers report never changes routes, delivery scores or the push pace, and if the broker is unreachable the room carries on exactly as before.

Virtual repeater a second identity on the room's radio that relays for the mesh

Import private key

Virtual repeater

Relay packets — turning this off stops relaying at once (queued relays are dropped); it keeps advertising

Name Scoped floods unscoped floods are always relayed

Position , lat, lon in degrees; blank = the room's (set it a little apart so map icons don't overlap)

Airtime cap % Loop detection Adverts every min flood every h

Virtual companion a chat node on the room's radio that MeshCore apps connect to over the network

Virtual companion

Import private key

Optional. If no private key is imported, one is generated randomly the first time the companion is turned on and kept in the config, so its identity stays the same across restarts.

Name TCP port Allowed addresses

Auto advert every min as

Connect a MeshCore app to this server's address and port as a WiFi/TCP companion. The port is open only while the companion is enabled. The companion protocol has no password: anyone who can reach the port can read its messages and send as it, so keep it on your own network (never forward it from the internet) and list allowed addresses (e.g. 192.168.1.0/24) to narrow it further. Radio settings, the Bluetooth PIN, reboot and factory reset from the app are acknowledged and ignored. Messages between the companion and this room or its repeater never go on the air.

Tenant rooms more rooms on this radio, each with its own page, members and passwords

Room name Path Private key

Join password Admin password Web UI password

If no private key is entered, one is generated randomly. Each room gets its own page at its path, where its admins (web UI password) see its members and the map, chat, advert, resync, suggest routes, kick and ban. The join and admin passwords are what people use from their MeshCore apps. Tenant rooms share this radio, its map and its airtime; nothing a tenant does reaches outside its room.

Adverts the room's, and the virtual repeater's when it's on

Advert
zero-hop

Flood advert
whole mesh

Room chat

Best neighbour repeaters (by trace packet loss)

Members Room members · tap a row for details

Suspended Inactive members, will be returned to member list when they are heard on the mesh

Banned Room members who FAFO'd

Repeater map

Select a repeater from the map

MQTT observer admin only

EnabledIATA Status Packets RX Queue

Name Host Port Audience Path Prefix Enabled TLS Verify TLS

Welcome DMs admin only · sent only to newly logged-in members

Send welcome DM

Welcome message

Name-unknown hint (optional; appended when the member has not sent an advert)

Use {room} for the room name. The rendered welcome message and optional hint together may be at most 151 UTF-8 bytes.

Suggest a route

Admin log in

MQTT augmentation listen to the observer network as well as the radio

Virtual repeater a second identity on the room's radio that relays for the mesh

Virtual companion a chat node on the room's radio that MeshCore apps connect to over the network

Tenant rooms more rooms on this radio, each with its own page, members and passwords

Adverts the room's, and the virtual repeater's when it's on

Room chat

Best neighbour repeaters (by trace packet loss)

Members Room members · tap a row for details

Suspended Inactive members, will be returned to member list when they are heard on the mesh

Banned Room members who FAFO'd

Repeater map

MQTT observer admin only

Welcome DMs admin only · sent only to newly logged-in members

Repeaters heard