Settings — Modules & Admin
Configure optional feature modules and perform device administration. Modules extend Meshtastic with specialized capabilities — each can be independently enabled or disabled.
💡 Tip: You only need to enable the modules you actually use. Disabling unused modules reduces airtime, saves battery, and simplifies your configuration.
Module settings use a card-based layout with toggle switches, dropdowns, text fields, and sliders:
Module Configuration
MQTT Module
Bridges mesh messages to and from an MQTTMQTT (Message Queuing Telemetry Transport). A lightweight messaging protocol designed for small sensors and mobile devices, enabling efficient data transmission in the Meshtastic network for Internet connectivity and integration with IoT platforms. See https://en.wikipedia.org/wiki/MQTT. In Meshtastic, MQTT is used to connect a node to the internet, and can be used to connect multiple meshes to each other. broker for internet connectivity. This is how you extend your mesh beyond radio range or integrate with home automation systems.
| Setting | Description |
|---|---|
| Enabled | Toggle MQTTMQTT (Message Queuing Telemetry Transport). A lightweight messaging protocol designed for small sensors and mobile devices, enabling efficient data transmission in the Meshtastic network for Internet connectivity and integration with IoT platforms. See https://en.wikipedia.org/wiki/MQTT. In Meshtastic, MQTT is used to connect a node to the internet, and can be used to connect multiple meshes to each other. bridge |
| Server | MQTTMQTT (Message Queuing Telemetry Transport). A lightweight messaging protocol designed for small sensors and mobile devices, enabling efficient data transmission in the Meshtastic network for Internet connectivity and integration with IoT platforms. See https://en.wikipedia.org/wiki/MQTT. In Meshtastic, MQTT is used to connect a node to the internet, and can be used to connect multiple meshes to each other. broker address |
| Username | Authentication username |
| Password | Authentication password |
| Encryption | Encrypt MQTTMQTT (Message Queuing Telemetry Transport). A lightweight messaging protocol designed for small sensors and mobile devices, enabling efficient data transmission in the Meshtastic network for Internet connectivity and integration with IoT platforms. See https://en.wikipedia.org/wiki/MQTT. In Meshtastic, MQTT is used to connect a node to the internet, and can be used to connect multiple meshes to each other. payloads |
| ⚠️ Deprecated — JSON support removed from firmware; field is ignored | |
| TLS | Use secure connection |
| Root Topic | Base MQTTMQTT (Message Queuing Telemetry Transport). A lightweight messaging protocol designed for small sensors and mobile devices, enabling efficient data transmission in the Meshtastic network for Internet connectivity and integration with IoT platforms. See https://en.wikipedia.org/wiki/MQTT. In Meshtastic, MQTT is used to connect a node to the internet, and can be used to connect multiple meshes to each other. topic path |
| Map Report | Publish position for public map |
See MQTT for a detailed usage guide including encryption, privacy, and broker setup.
Serial Module
Enables serial port communication for external device integrations (GPSGPS (Global Positioning System). A satellite positioning system. A node with a GPS module determines its own location and can report that position to the mesh. modules, sensors, or custom hardware). When enabled, the node's serial port can send and receive protobufProtobuf (Protocol Buffers). A method developed by Google for serializing structured data, used in Meshtastic for efficient communication protocol between devices. or text data, allowing external microcontrollers or computers to interact with the mesh.
| Setting | Description |
|---|---|
| Enabled | Activate serial communication |
| Echo | Echo received serial data back |
| Mode | Text, ProtobufProtobuf (Protocol Buffers). A method developed by Google for serializing structured data, used in Meshtastic for efficient communication protocol between devices., or NMEA output |
| RXRX (Receive). The receiving of data over the radio link./TXTX (Transmit). The transmitting of data over the radio link. Pins | GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pins for serial connection |
| Baud Rate | Serial communication speed |
External Notification Module
Controls buzzer, LEDLED (Light-Emitting Diode). An indicator light on a device. The External Notification module can drive one in response to mesh activity., or vibration alerts on your radio hardware. Useful for devices that need to physically signal when a message arrives — particularly helpful for unattended or outdoor installations.
| Setting | Description |
|---|---|
| Enabled | Activate notifications |
| Alert Message | Notify on incoming messages |
| Alert Message Buzzer | Use buzzer for messages |
| Alert Message Vibra | Use vibration for messages |
| Alert Bell | Notify on bell character |
| Output (GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device.) | Pin for notification output |
| Active | High or Low active |
| Duration (ms) | Notification length |
| Use I2S as Buzzer | Use I2S audio output |
Store & Forward Module
Buffers messages for nodes that were temporarily offline, then replays them when those nodes reconnect. Essential for meshes where nodes go in and out of range regularly — ensures messages aren't lost during brief disconnections.
| Setting | Description |
|---|---|
| Enabled | Activate store and forward |
| Heartbeat | Periodically announce this node's store-and-forward capability |
| Records | Maximum stored messages |
| History Return (max) | Max messages to replay |
| History Return (window) | Time window for replay |
| Server | Act as a store-and-forward server for the mesh (requires ample memory, e.g. ESP32ESP32A chipset of microcontroller made/designed by Espressif, used by a number of devices. Higher power usage than nRF52, but often cheaper and supports Wi-Fi if desired. with PSRAM) |
💡 Tip: Store and Forward works best on nodes with ample memory (ESP32ESP32A chipset of microcontroller made/designed by Espressif, used by a number of devices. Higher power usage than nRF52, but often cheaper and supports Wi-Fi if desired. with PSRAM). Router nodes are ideal candidates since they're typically always-on.
Range Test Module
Automated range testing tool for evaluating link quality between nodes. When enabled, the node periodically transmits test messages with incrementing counters. A receiver node logs these messages, allowing you to walk or drive away and later analyze at what distance messages stopped arriving.
| Setting | Description |
|---|---|
| Enabled | Activate range testing |
| Sender Interval (s) | Time between test transmissions |
| Save CSV | Log received test data to SD card |
Telemetry Module
Controls what telemetry data your node shares with the mesh. Telemetry includes device health (battery, uptime) and environmental sensor data (temperature, humidity, pressure).
| Setting | Description |
|---|---|
| Device Metrics Interval | How often to report device metrics |
| Environment Metrics Interval | How often to report environment sensors |
| Air Quality Enabled | Report particulate sensor data |
| Power Metrics Enabled | Report power usage |
See Telemetry & Sensors for supported sensors and configuration recommendations.
Canned Message Module
Pre-configured messages accessible from the device's physical buttons (for radios with rotary encoders, keypads, or similar input hardware). Define a list of quick-send messages that can be transmitted without a phone connected — ideal for field use.
| Setting | Description |
|---|---|
| ⚠️ Deprecated — current firmware may ignore this toggle | |
| Messages | Newline-separated list of messages |
| Send Bell | Play bell sound on send |
| Rotary Encoder | Enable rotary encoder input |
| Up/Down/Press Pins | GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pin assignments for input |
Audio Module
Codec2 audio support for low-bandwidth voice communication over the mesh. This is an experimental feature that encodes voice into very small data packets using the Codec2 codec.
| Setting | Description |
|---|---|
| Enabled | Activate audio module |
| Codec2 Rate | Audio quality/bandwidth tradeoff |
| I2S Word Select | GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pin for I2S WS |
| I2S Data In | GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pin for I2S DIN |
| I2S Data Out | GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pin for I2S DOUT |
⚠️ Note: Audio requires specific hardware (I2S microphone and speaker). Voice quality is very low-bandwidth — think "understandable radio voice," not phone-call quality.
Remote Hardware Module
GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. control over the mesh network. Allows a remote node to read or write GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pins on another node — useful for activating relays, reading switches, or controlling external hardware from a distance.
| Setting | Description |
|---|---|
| Enabled | Activate remote GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. access |
| Allow Undefined Pins | Allow access to any GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pin (security risk) |
| Available Pins | Up to 4 GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pins this node exposes for remote read/write |
⚠️ Warning: Enabling "Allow Undefined Pins" gives remote nodes access to all GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pins, which could interfere with the radio's own hardware. Only enable on dedicated GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. nodes.
Neighbor Info Module
Broadcasts information about directly heard neighbors, enabling mesh topology mapping. Each enabled node periodically shares a list of the other nodes it can hear and their signal quality.
| Setting | Description |
|---|---|
| Enabled | Activate neighbor broadcasting |
| Update Interval (s) | How often to broadcast neighbor list |
| Transmit Over LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures. | Also broadcast neighbor info over LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures., not just MQTTMQTT (Message Queuing Telemetry Transport). A lightweight messaging protocol designed for small sensors and mobile devices, enabling efficient data transmission in the Meshtastic network for Internet connectivity and integration with IoT platforms. See https://en.wikipedia.org/wiki/MQTT. In Meshtastic, MQTT is used to connect a node to the internet, and can be used to connect multiple meshes to each other./phone. Unavailable on a channel using the default key and name |
See Discovery for how to use neighbor data for mesh topology exploration.
Ambient Lighting Module
Controls onboard NeoPixel or other addressable RGB LEDsLED (Light-Emitting Diode). An indicator light on a device. The External Notification module can drive one in response to mesh activity. on supported hardware. Can be used for visual status indicators, notification lights, or decorative effects.
| Setting | Description |
|---|---|
| LEDLED (Light-Emitting Diode). An indicator light on a device. The External Notification module can drive one in response to mesh activity. State | Turn the LEDLED (Light-Emitting Diode). An indicator light on a device. The External Notification module can drive one in response to mesh activity. on or off |
| Current | LEDLED (Light-Emitting Diode). An indicator light on a device. The External Notification module can drive one in response to mesh activity. current limit (0–31) |
| Red / Green / Blue | Individual color channel values (0–255) |
Detection Sensor Module
Turns your node into a motion or door sensor alert system. When a GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pin detects a state change (motion detected, door opened), the node broadcasts an alert message over the mesh.
| Setting | Description |
|---|---|
| Enabled | Activate detection sensor |
| Monitor Pin | GPIOGPIO (General Purpose Input/Output). An uncommitted digital signal pin on a device. pin connected to sensor |
| Detection Trigger Type | How the pin's state maps to a detection event (e.g. active high/low, edge-triggered) |
| Use Input Pullup Mode | Enable the pin's internal pull-up resistor |
| Minimum Broadcast (s) | Minimum time between alert broadcasts |
| State Broadcast (s) | Periodic state broadcast interval |
| Send Bell | Include bell character in alerts |
| Friendly Name | Custom name for this sensor |
Paxcounter Module
People counter using WiFi and BLEBLE (Bluetooth Low Energy). The default wireless connection between a node and a phone client. probe requests. Counts nearby devices by passively listening for probe requests that phones and laptops emit when scanning for networks. Available only on ESP32ESP32A chipset of microcontroller made/designed by Espressif, used by a number of devices. Higher power usage than nRF52, but often cheaper and supports Wi-Fi if desired. devices.
| Setting | Description |
|---|---|
| Enabled | Activate people counting |
| Update Interval (s) | How often to report counts |
💡 Tip: Paxcounter is useful for estimating foot traffic at trailheads, event venues, or other locations. Counts are approximate — one person may carry multiple devices.
TAK Module
Team Awareness Kit integration for interoperability with ATAKATAK (Android Team Awareness Kit). The Android TAK client. An official Meshtastic plugin forwards its Cursor on Target traffic over the mesh. and WinTAK. See TAK Integration for detailed setup and usage.
Administration
Remote Administration
Remotely configure nodes that share your admin key:
- Select the target node in the node list.
- Navigate to Settings for that node.
- Modify configuration.
- Tap Save — changes are sent over the mesh.
⚠️ Requires: Admin key configured on both your node and the target node.
Clean Node Database
Removes stale nodes from your local database that haven't been heard in a configurable time window.
Factory Reset
Resets all settings to factory defaults. This cannot be undone.
Reboot
Remotely reboot a connected or administered node.
Debug Panel
Opens the Packets and App logs tabs for viewing, filtering, and exporting diagnostic output. See Debug Logs for the full walkthrough.
Troubleshooting Remote Admin
- "No response from target node" — the target may be out of range, offline, or have a mismatched admin key. Verify the admin key matches on both nodes.
- Changes not applying — some settings require a reboot to take effect. Try the Reboot action after saving.
- Can't see remote settings — ensure your node has the admin key for the target node. The admin channel is configured automatically when an admin key is set.
Related Topics
- Settings — Radio & User — core radio and user profile settings
- Module configuration reference — detailed module docs on meshtastic.org
- FAQ — common questions on meshtastic.org