+++
title = "Repeater and Room Management"
weight = 9
+++

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 / Feature | Repeater | Room Server | Requires 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](https://docs.meshcore.io/cli_commands/) 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`).
