Files
mc-webui/docs/rpt-mgmt.md
T
MarekWo 0d69947bfd docs: cover the My Repeaters (repeater administration) feature
user-guide.md gains a full My Repeaters section (adding repeaters,
saved passwords + the wrong-password/unreachable ambiguity, path
editing, and the six management tools) and fixes the stale Quick
Access placement list (now 12 items, real labels). architecture.md
documents the /api/repeaters/* endpoint family with its shared error
mapping, the repeaters DB table, and a DeviceManager subsection on
serialization, login sessions, CLI reply correlation, settings
batches and the actions whitelist. whatsnew.md adds three New
features bullets, a Reliability note (console login reports role),
and Deploy notes (meshcore>=2.3.7 rebuild, plaintext password
trade-off). rpt-mgmt.md now points to the built-in panel first.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-18 19:33:27 +02:00

62 lines
2.3 KiB
Markdown

# How to Manage Your Repeater
> **Note:** mc-webui now ships a built-in repeater administration panel — **My Repeaters** in the main menu — with status, telemetry, neighbours, a remote CLI, settings, and actions. See [My Repeaters in the user guide](user-guide.md#my-repeaters-repeater-administration). The DM-based method below still works and remains useful as a fallback.
This guide explains how to manage a MeshCore repeater device directly from the mc-webui interface using Direct Messages.
---
## 1. Add Your Repeater to Contacts
- Wait for your repeater's first `advert`
- Click on the Contacts icon
<img src="../images/RPT-Mgmt-01-new-rpt-notification.png" alt="New repeater notification" width="200px">
- Go to `Pending contacts` panel
<img src="../images/RPT-Mgmt-02-new-rpt-pending.png" alt="Pending contacts" width="200px">
- Search for your repeater on the list and approve it
<img src="../images/RPT-Mgmt-03-new-rpt-approve.png" alt="Approve repeater" width="200px">
- Reset your search filter (it is recommended to leave COM selected only) and return to the main chat view
<img src="../images/RPT-Mgmt-04-back-to-home.png" alt="Return to home" width="200px">
---
## 2. Login to Your Repeater and Initialize Conversation
- Open the `mc-webui Console`
<img src="../images/RPT-Mgmt-05-open-console.png" alt="Console" width="200px">
- Enter the `login <REPEATER_NAME> <password>` command
- Type the `msg <REPEATER_NAME> "Hello"` command (you can use any message text)
<img src="../images/RPT-Mgmt-06-login-and-msg.png" alt="Login" width="200px">
- Return to the main chat view
---
## 3. Send Commands to Your Repeater
- From the main chat view, click on the DM icon
<img src="../images/RPT-Mgmt-07-dm-notification.png" alt="DM notification" width="200px">
- Find your repeater's name on the list
<img src="../images/RPT-Mgmt-08-dm-open.png" alt="Open DM chat" width="200px">
- Start sending commands to your repeater as if it were a regular DM conversation
<img src="../images/RPT-Mgmt-09-rpt-commands.png" alt="Repeater commands" width="200px">
For full commands reference, see [Repeater & Room Server CLI Reference](https://github.com/meshcore-dev/MeshCore/wiki/Repeater-&-Room-Server-CLI-Reference).
**Note:** Not all commands may work at the moment.