Repeater and Room Management

Repeaters and room servers can be managed remotely through a shared management interface. Both device types use the same set of tabs, but some features are only available for one or the other.

Tab / FeatureRepeaterRoom ServerRequires Admin
Status
CLI
Neighbors
Access Control (ACL)
Regions
Settings
Guest Access✔ (to configure)

Logging In

  1. For repeaters, click the contact in the contact list (opens the management interface directly). For room servers, open the contact detail dialog and click Room Management (clicking in the list opens the chat instead).
  2. Enter the device password. Optionally check "Save password" to remember it for future sessions.
  3. Meshy sends a login command and waits up to 15 seconds for a response.

The login response indicates whether you have admin or non-admin access. Non-admin users only see the Status tab. Admin users see all tabs (CLI, Neighbors, Access Control, Regions, Settings).

Status

Shows real-time operating data from the remote node:

  • Clock -- the device's current time (admin only). If the time is off by more than 5 minutes, a drift warning appears with a Sync button (only when the clock is behind). If the clock is ahead, a Reset button appears instead (firmware rejects setting time backwards).
  • System -- battery (% and mV), uptime, message queue length, error events.
  • Radio -- last RSSI, last SNR, noise floor, TX/RX airtime, channel utilization, duty cycle.
  • Packets -- sent/received counts, receive errors, flood/direct breakdown, duplicate counts.

Click Refresh to request updated status (15-second timeout).

CLI Commands

An interactive command-line interface for the remote node (admin only):

  • Quick command buttons -- get name, get radio, get tx, ver, neighbors, advert, clock.
  • Command input -- type any CLI command and press Enter or click Send.
  • Output area -- displays command responses in a monospace text area.

Commands are sent as CLI data frames to the remote node. See the MeshCore CLI reference for a complete list of commands available on repeaters, room servers, and sensors.

Neighbors

Lists other nodes heard via zero-hop advertisements (admin only, repeaters only). Room server firmware does not support neighbor queries, so this tab is hidden for room server contacts.

  • Each entry shows the node name (or key prefix), public key, time since last heard, and SNR.
  • Refresh reloads the neighbor list. Load More fetches additional entries.
  • Map shows neighbors with known locations on a map, with SNR labels on each link.

Access Control (ACL)

Manage the device's access control list (admin only):

  • Each entry shows the node name (or key prefix), permission role, and a remove button.
  • Permission roles: Admin (full access), Read-Write (can send and receive), Read Only (can only read messages).
  • Add opens a contact picker where you select a contact and a role, then sends a setperm command.
  • Remove deletes the entry from the ACL (with confirmation).
  • Refresh reloads the ACL from the device.

The ACL works the same way for both repeaters and room servers. Note that room server firmware only reports Admin entries in the ACL response -- if you add a contact with Read-Write or Read Only, the permission is applied on the device, but the entry will not appear in the list until it is promoted to Admin.

Regions

Query and configure available regions on the device (admin only):

  • Regions and the default scope are fetched via CLI commands (region, region default).
  • Shows region names with indentation representing the hierarchy. Flood-enabled and home regions are marked.
  • Add / Remove to modify the region list.
  • Default Scope sets which region scopes all flood packets by default.
  • Click Apply to send region changes to the device.

Settings

Fetch and modify remote device configuration, organized into sections (admin only):

  • Basic -- device name, repeat mode. Admin and guest passwords can be changed separately. For room servers, a Guest Access toggle controls whether users without a password can join with read-only access.
  • Location -- latitude and longitude. A Pick from Map button opens a map dialog for visual selection.
  • Radio -- frequency, bandwidth, spreading factor, coding rate, TX power.
  • Advert -- advertisement interval, flood advertisement interval.
  • Telemetry -- request current telemetry data from the device.
  • Danger Zone -- reboot the remote node (requires confirmation).

Each section has its own Fetch and Save buttons. Settings are fetched and saved via CLI commands (e.g., get name, set name, get radio, set radio).