Network Troubleshooting Diagnosing Meshtastic Network Problems This guide covers systematic diagnosis of common Meshtastic network issues: nodes that can't hear each other, poor range, network congestion, and routing failures. Diagnostic framework Work from the bottom up: radio layer first, then routing, then application. Radio layer: Can the nodes physically hear each other? Check RSSI/SNR. Configuration: Are both nodes on the same preset and channel? Routing: Is the path between nodes working? Use Trace Route. Application: Is the app connected properly? Is the message actually sending? Problem: Two nodes can't communicate Check 1: Same preset? Nodes on different presets cannot hear each other. Verify: meshtastic --nodes # Check modem_preset in the output Both nodes must show the same preset (e.g., LONG_FAST or MEDIUM_SLOW). If different: change one to match the other. Check 2: Same channel and PSK? Nodes must be on the same channel with the same PSK. The default public channel (LongFast) has an empty PSK. If you've customized your channel, the other node needs the same configuration. meshtastic --info # Shows channel list with PSK hashes PSK hash mismatch = nodes won't communicate even if physically in range. Check 3: Physical range and line of sight In the Meshtastic app , check if the node appears in the node list with any RSSI/SNR value. If it appears with RSSI < −120 dBm or SNR < −10 dB, the signal is at the noise floor - unreliable communication. If it doesn't appear at all, no packets are being received. Test: bring both devices to within 100 feet of each other (no obstacles). If they communicate at that distance, it's a range/obstruction problem. If they still can't communicate at 100 feet, it's a configuration problem. Problem: Intermittent message delivery Check: Hop count Messages requiring more hops have higher failure rates. Check your hop limit setting: meshtastic --get lora.hop_limit Default is 3. If messages are being dropped across long paths, try increasing to 5: meshtastic --set lora.hop_limit 5 Check: Network congestion In dense networks (20+ nodes), Long Fast preset can cause congestion. Symptoms: high message drop rate even with good RSSI, large delays. Solution: migrate to Medium Slow or Medium Fast preset. Requires coordination with all network participants - all nodes must change at the same time. Check: Router node availability If a critical router node goes offline, messages that depended on that path fail. Use Trace Route before and after to confirm the path change: meshtastic --traceroute !nodeId Problem: Poor range from a new repeater Antenna connected? An unconnected antenna transmits into the PCB and can damage the radio front-end. Verify the antenna is finger-tight. Some boards have a separate BLE antenna and LoRa antenna - ensure both are connected. Correct antenna type? Most boards use SMA or u.FL connectors. Verify your antenna has the correct connector type and is rated for 915 MHz. An 868 MHz antenna will work but at reduced efficiency. TX power set correctly? Check that TX power hasn't been set to an unusually low value: meshtastic --get lora.tx_power Obstructions: Even a metal enclosure, HVAC equipment, or tree canopy directly around the antenna can reduce range significantly. Test with the antenna in the clear before committing to a location. Repeater Performance and Maintenance A deployed repeater requires periodic attention to maintain performance. This page covers the key maintenance tasks and performance metrics for Meshtastic Router/Repeater nodes. Key performance indicators Metric Healthy range Action if outside range Node uptime >95% over 30 days Investigate power system or firmware stability Average RSSI to neighbors −70 to −100 dBm <−110 suggests obstruction or antenna problem SNR to nearest neighbor >5 dB <0 dB: signal at noise floor, link unreliable Battery voltage (solar) >3.5V (LiFePO4) <3.2V repeatedly = undersized power system Packets forwarded per hour Varies by location Sudden drop to 0 = node possibly offline Routine maintenance checklist (quarterly) Check node appears on meshmap.net or community monitoring system Verify RSSI/SNR to neighboring nodes hasn't significantly degraded Check battery voltage logs if monitoring - look for downward trend Inspect solar panel: clean off debris, verify no shading from new growth Check antenna connector for corrosion or loosening (especially after winter) Verify firmware version - update if significantly behind current release Check enclosure for water intrusion - condensation inside is an early warning sign Firmware update process for deployed nodes Updating firmware on a deployed repeater requires physical access. Prepare: Schedule a maintenance window and notify the community (the node will be offline during update) Bring: laptop, USB cable for your device type, and the firmware binary or web browser access Before disconnecting: record current configuration (TX power, role, channel settings, position) with meshtastic --info > config_backup.txt Flash new firmware via web flasher (flasher.meshtastic.org) Verify settings after flash - firmware updates occasionally reset some settings to defaults Confirm node reappears on the network before leaving the site Common hardware failures Symptom Likely cause Fix Node gone offline after storm Water intrusion, lightning strike, blown fuse Inspect enclosure, check fuse, examine for burn marks on PCB Range suddenly reduced Antenna connector loosened or corroded Re-seat antenna, check connector for oxidation, replace if needed Frequent reboots Power supply instability (low battery/solar) Check battery voltage, check charge controller output Firmware crash loop Corrupted flash or incompatible firmware Factory reset and reflash BLE not discoverable BLE antenna loose (V3 only); software issue For V3: reseat u.FL BLE antenna. Otherwise reflash. When to replace vs. repair LoRa boards are inexpensive ($15 - 75). General guidance: Physical damage to SMA connector or RF front-end: replace board. Repair costs often exceed replacement. Software issue (firmware bugs, configuration corruption): reflash before considering hardware replacement. Battery degradation (LiFePO4): replace battery after 5+ years or when capacity drops below 70% of original. Solar panel degradation: typical panels lose 0.5% efficiency per year. Replace if output is more than 20% below original spec after 10+ years.