Meshtastic
Everything about the Meshtastic protocol: how it works, how to set it up, and technical details.
📖 Start Here — Meshtastic Guide
Meshtastic is the most widely deployed LoRa mesh platform - it has the largest community, the mos...
How Meshtastic Works
The Meshtastic protocol, routing, and architecture explained.
Meshtastic Protocol Overview
Meshtastic is an open-source mesh networking project built on LoRa radio hardware. It has a large...
Meshtastic Flooding Mesh Protocol Explained
Understanding how Meshtastic actually routes messages helps you make better configuration decisio...
Meshtastic Node IDs, Addresses, and Naming
Understanding how Meshtastic nodes are identified helps you interpret the node list, configure di...
Setting Up Meshtastic
Step-by-step device configuration for Meshtastic.
Meshtastic Setup Guide
Getting started with Meshtastic is straightforward. The project has extensive documentation and a...
Initial Node Configuration Checklist
When you get a new Meshtastic node, running through a standard configuration checklist ensures it...
Advanced Configuration for Infrastructure Nodes
Infrastructure nodes (routers, backbone repeaters) require additional configuration beyond the de...
Device Roles — All 12
Personal Device Roles
Personal roles are designed for individual users who want to send and receive messages. They vary...
Infrastructure Roles: Router and Repeater
Infrastructure roles are for fixed, well-placed nodes that genuinely improve mesh coverage for ot...
Specialized Roles
Specialized roles optimize node behavior for specific use cases: tracking, sensing, and tactical ...
Channels & Encryption
Telemetry & Monitoring
Meshtastic CLI Reference
MQTT & Internet Gateway
Meshtastic MQTT Setup
MQTT lets a Meshtastic node forward all mesh traffic to the internet, making your local mesh visi...
Building a Meshtastic Internet Gateway
A Meshtastic internet gateway bridges local LoRa radio traffic to the internet and can serve as a...
MQTT Topic Structure and Packet Format
Understanding Meshtastic's MQTT topic structure and packet encoding lets you build integrations, ...
Preventing MQTT Message Loops
A common misconfiguration in networks with MQTT gateways is the "MQTT loop" - packets sent over L...
Advanced Features
Meshtastic Web Interface and Remote Access
Many Meshtastic users don't realize a full web-based interface is available in addition to the mo...
Meshtastic Module Configuration Reference
Meshtastic's module configuration system enables advanced features beyond basic mesh communicatio...
Traceroute and Path Diagnostics
What Is Meshtastic Traceroute? Traceroute is a diagnostic feature built into Meshtastic firmware ...
Neighbor Info and Signal Mapping
What Is the Neighbor Info Module? The Neighbor Info module is a built-in Meshtastic feature that ...
Integrations & Automation
Bridging Meshtastic with APRS, external services, and scripting automation via the Python library.
Meshtastic APRS Gateway
What is APRS? APRS - Automatic Packet Reporting System - is an amateur radio protocol designed fo...
Meshtastic Python Scripting
The meshtastic Python Library The official meshtastic Python library provides programmatic access...
Home Assistant Integration via MQTT
Overview Integrating Meshtastic into Home Assistant unlocks powerful home automation possibilitie...
Node-RED Flows for Mesh Automation
Overview Node-RED is a visual flow-based programming tool that acts as powerful middleware betwee...
Security & Privacy
Channel Management
How Meshtastic channels and PSKs work, how to share them via QR code, and strategies for deployin...
Understanding Channels and PSKs
Overview Meshtastic supports up to 8 simultaneous channels (index 0 - 7). Channel 0 is the primar...
Sharing Channels via QR Code
How Channel Sharing Works Meshtastic encodes channel configuration as a URL containing a Base64-e...
Channel Strategy for Community Networks
Public Infrastructure Nodes Nodes acting as public infrastructure (repeaters, routers) are common...
Network Diagnostics and Health Monitoring
Tools and techniques for understanding the health of your Meshtastic mesh.
Reading Network Statistics in the Meshtastic App
Understanding what your Meshtastic network is actually doing requires knowing how to read the sta...
Using the Meshtastic Python CLI for Diagnostics
The Meshtastic Python package ships both a library and a command-line interface (CLI). The CLI is...
Mesh Topology and Path Analysis
Knowing how your messages travel through the mesh is essential for identifying bottleneck nodes, ...
Common Network Problems and Solutions
Meshtastic networks are remarkably self-organizing, but they are not self-diagnosing. When the me...
Building a Meshtastic Network Map
A network map shows you which nodes can hear each other, the quality of each link, and how messag...
Meshtastic Python API
Complete guide to the Meshtastic Python library: connection, messaging, automation, and API refer...
Getting Started with the Meshtastic Python Library
The Meshtastic Python library (meshtastic on PyPI) provides a clean API for connecting to Meshtas...
Automating Meshtastic: Practical Scripts
The Meshtastic Python library enables powerful automation workflows. This page provides four comp...
Meshtastic Python API Reference
This page documents the key classes, methods, and patterns of the Meshtastic Python library. It c...
Meshtastic Modules and Plugins
Telemetry Module: Device, Environment, and Power
The Telemetry module broadcasts sensor data from your node across the mesh - battery voltage, tem...
Store and Forward Module
The Store and Forward module lets a designated node buffer messages for clients that were offline...
Range Test Module
The Range Test module automates signal strength measurement for deployment validation - letting y...
External Notification and Canned Messages
External Notification Module The External Notification module triggers a visual or audio alert on...
Serial, MQTT, and Ambient Light Modules
Serial Module The Serial module lets external hardware send and receive Meshtastic messages over ...
Encryption and Privacy
Meshtastic Configuration Reference
Comprehensive reference for all settings under Config > Device, Config > Position, and Config > N...
Device Configuration Settings
The Device configuration section (Config > Device) controls fundamental node behavior: its role i...
Position Configuration Settings
The Position configuration section (Config > Position) controls how your node acquires, reports, ...
Network Configuration Settings
The Network configuration section (Config > Network) controls how ESP32-based Meshtastic nodes co...
Meshtastic Apps and Interfaces
Meshtastic Android App Overview
The Meshtastic Android app is the primary interface for configuring and using Meshtastic devices....
Meshtastic iOS App Overview
The Meshtastic iOS app provides core functionality for iPhone and iPad users, including messaging...
Meshtastic Web Client and Python CLI
Meshtastic Web Client The Meshtastic Web Client (client.meshtastic.org) provides a browser-based ...