Repeater commands
A cheat sheet for the MeshCore repeater command-line — every command the node accepts over the serial console or remote admin, grouped by what it does. Pick a firmware version to see exactly what it supported. Click any command to copy it.
Power & reboot
Restart the node.
- Careful
Power the device off (alias: shutdown).
- Careful
Same as poweroff.
Reset the clock to a fixed epoch, then reboot.
Begin an over-the-air firmware update.
- USB onlyCareful
Format the filesystem — wipes all settings (factory reset).
- Build-gated
Low-power mode (nRF52: instant, ESP32: after 2 min).
Identity & info
Firmware version and build date.
Hardware / manufacturer name.
Configured node role.
This node’s public key (hex).
- USB onlyReboot
Private key — rekeys the node.
Node name shown in adverts.
Owner / contact note (use | for newlines).
- Build-gated
Bootloader version (nRF52 only).
Passwords & access control
Set the admin password.
Set the guest (read-only) password.
Allow guests to read config without the admin password.
Set a client’s permission: 0 guest · 1 read-only · 2 read-write · 3 admin.
- USB only
Print the access-control list.
Radio
- Reboot
LoRa frequency (MHz), bandwidth (kHz), spreading factor and coding rate.
freq 150–2500 · bw 7.8–500 · sf 5–12 · cr 5–8
- USB onlyReboot
Frequency only (MHz).
Transmit power.
-9 to 30 dBm
Switch radio params temporarily, then auto-revert.
mins > 0
- Build-gated
RX boosted gain (SX1262/1268/LR1110).
Forwarding & routing
Whether this node repeats (forwards) packets.
Routing loop-detection strictness.
Path-ID hash size.
0, 1 or 2
Max hops for scoped floods.
0–64
- New
Max hops for unscoped floods.
0–64
- New
Max hops for advert floods.
0–64
Allow multiple ACKs per packet.
0 or 1
Timing & airtime
Target TX duty-cycle percent.
1–100
- Deprecated
Airtime factor.
Base receive delay.
0–20
Flood retransmit delay factor.
0–2
Direct-traffic delay factor.
0–2
Interference (noise) threshold.
AGC reset interval (rounded to multiples of 4s).
Advertising
Send a flood advertisement now.
Send a zero-hop (neighbours-only) advert now.
Zero-hop advert interval.
60–240 min (0 = off)
Flood advert interval.
3–168 h (0 = off)
Location
Node latitude.
Node longitude.
Battery ADC calibration (0 = board default).
0–10
Neighbours
List recently heard neighbours.
Forget a neighbour by public key.
Send a zero-hop neighbour-discovery request.
Clock
Show current UTC time.
Sync clock to the sender’s timestamp.
Set clock to a Unix epoch (cannot go backwards).
Stats & logging
Reset all statistics counters.
- USB only
Battery, uptime, queue length, debug flags.
- USB only
Noise floor, RSSI/SNR, airtime, errors.
- USB only
Sent / received packet counters.
Start capturing the receive log to storage.
Stop capturing the receive log.
Delete the stored log.
- USB only
Dump the stored log to the serial console.
Regions
Region scoping controls where floods propagate. `region` with no argument lists every defined region.
List all defined regions.
Show one region and its parent / flood flag.
Create a region (flood allowed by default).
- New
Define a hierarchy in one line (| or , branches).
Delete a region (must be empty).
Begin bulk indented region load (blank line ends it).
Persist region changes to storage.
View or set the home region.
View or set the default scope (<null> to clear).
Allow flooding in a region (* = wildcard).
Deny flooding in a region.
List regions by flood permission.
GPS
Available only on GPS-enabled builds.
- Build-gated
Show GPS status (fix, sats).
- Build-gated
Enable the GPS hardware.
- Build-gated
Disable the GPS hardware.
- Build-gated
Sync the clock from GPS time.
- Build-gated
Copy the current GPS fix into node lat/lon.
- Build-gated
View / set the location-sharing policy for adverts.
Sensors
List custom sensor variables.
Read one sensor variable.
Write one sensor variable.
Bridge & power mgmt
Bridge keys appear only on bridge builds; pwrmgt on nRF52 power-managed builds.
Configured bridge type (rs232 / espnow / none).
- Build-gated
Enable / disable the bridge.
- Build-gated
Bridge routing delay.
0–10000 ms
- Build-gated
Which packet stream to bridge.
- Build-gated
RS-232 baud rate.
9600–115200
- Build-gated
ESP-NOW channel.
1–14
- Build-gated
ESP-NOW shared secret (≤15 chars).
- Build-gated
Whether power management is supported.
- Build-gated
Current power source (external / battery).
- Build-gated
Last reset / shutdown reason.
- Build-gated
Boot voltage in mV.
Generated from the MeshCore firmware source at repeater-v1.16.0 — not just the docs.
Source files: CommonCLI.cpp simple_repeater / MyMesh.cpp
See also the MeshCore CLI reference ↗.