Skip to main content

Advanced Configuration for Infrastructure Nodes

Infrastructure nodes (routers, backbone repeaters) require additional configuration beyond the defaults to operate efficiently and reliably in a production network.

Power Management

InfrastructureThe nodesROUTER shouldrole neverautomatically uses power-saving sleep on ESP32 boards (the LoRa radio stays in standby so it can wake on incoming packets) - theythis cannot be disabled. If you need BLE, WiFi, or serial to receivestay andcontinuously relayavailable trafficon atan allinfrastructure times:node, use the CLIENT or ROUTER_LATE role instead. The settings below affect non-router nodes:

# DisableLight-sleep tuning (note: power.is_power_saving false is already the
# default for non-router roles, but ROUTER force-enables sleep for always-on infrastructure nodes:ESP32):
meshtastic --set power.is_power_saving false
meshtastic --set power.ls_secs 0 # 0 =selects nothe DEFAULT 5-minute light-sleep interval (it does NOT disable light sleep
meshtastic --set power.on_battery_shutdown_after_secs 0 # 0 = never shut downsleep)

Telemetry Configuration

Infrastructure nodes can report their own health metrics to the network:

# Enable device telemetry (battery, voltage, uptime) - firmware default is 1800 s (30 min):
meshtastic --set telemetry.device_update_interval 9001800 # every 1530 min

# Enable environment telemetry (if sensor equipped):
meshtastic --set telemetry.environment_update_interval 1800

# DisableReduce position telemetryairtime ifon usinga fixed positionnode by setting a long broadcast interval
# (savessetting bandwidth)0 does NOT disable broadcasts):
meshtastic --set position.position_broadcast_secs 0900

Hop Limit for Infrastructure Nodes

InfrastructureMeshtastic nodesrecommends oftenleaving serve as backbone relays and may need a higherthe hop limit thanat the default of 3 to(maximum ensure7). messagesIncreasing canit crossrarely theimproves fullcoverage network:and significantly increases channel congestion; address coverage gaps with better-placed router nodes instead of more hops:

# IncreaseDefault hopis limit3; foronly backboneraise nodes:this if you genuinely need it:
meshtastic --set lora.hop_limit 53

# Note: Higher hop limit increases channel utilization.utilization and rarely helps coverage.
# OnlyPrefer useadding 5-7well-placed hopsrouters whenover youraising havethe largehop geographic coverage requirements.count.

Ignore MQTT Setting

If your network has an MQTT gateway, configuresetting infrastructurelora.ignore_mqtt=true nodesmakes toa NOTnode re-broadcastdrop LoRa packets that cameentered the mesh via MQTT, which can reduce duplicate or looped traffic from MQTTthe (to prevent message loops):gateway:

# Preventignore_mqtt MQTT-originatedtells packetsthe node not to re-transmit over radio any packet that
# arrived from beingthe re-broadcastinternet over(MQTT), LoRa:which prevents echo loops:
meshtastic --set lora.ignore_mqtt true

Admin Channel Configuration

Set up a separate admin channel for network operations traffic, separate from the public community channel:channel. The ops-channel PSK must be a cryptographically random 256-bit key generated by the app (use psk random), not a human-typed string:

# Add a second channel for admin use:use (--ch-add both creates and names it):
meshtastic --ch-add meshtastic --ch-index 1 --ch-set name "OpsNet"OpsNet
meshtastic --ch-index 1 --ch-set psk "your-ops-channel-key="random # generates a secure random key; or supply a valid base64 32-byte key
meshtastic --ch-index 1 --ch-set uplink_enabled false # don't bridge to MQTT
meshtastic --ch-index 1 --ch-set downlink_enabled false

Configuration Backup

Always save configuration before deploying. A failed SD card or corrupted firmware update can lose your settings:settings. The export is YAML, not JSON, and is restored with --configure:

# Export full config to JSON:YAML:
meshtastic --export-config > node-config-backup-$(date +%Y%m%d).jsonyaml

# Restore from backup:
meshtastic --import-configconfigure node-config-backup-20260101.jsonyaml