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.

92 commands
USB only Serial console only — not accepted over-the-air.Reboot Takes effect only after a reboot.Careful Irreversible — double-check before running.Build-gated Only on firmware compiled with this feature.

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 ↗.