Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
122 changes: 83 additions & 39 deletions docs/config.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,104 @@
# Recommended Configuration Settings

In order to maintain a healthy mesh network, we recommend the following configuration settings for your Meshtastic devices.
To maintain a healthy mesh network, we recommend the following configuration settings based on your node's purpose. These settings prioritize network stability by reducing unnecessary "chattiness" on our shared 3kbps bandwidth (under MediumFast).

These settings are intended to facilitate a stable and reliable mesh network. They are based on the collective experience of the Mountain Mesh community and are subject to change as the mesh grows and evolves.
!!! info
These settings are based on the collective experience of the Mountain Mesh community. Settings are subject to change as the mesh grows.

## Radio configuration
## 📱 1. Personal Mobile Nodes

### Device
*For handhelds, vehicle-mounted units, and typical end-user devices.*

| Option | Recommended Config | Notes |
| --------------------------: | :------------------------ | :-------------------------------------------------------------------------------------------------------------- |
| Role | `CLIENT` or `CLIENT_MUTE` | See :fontawesome-brands-youtube: [Meshtastic Deployment Scenarios](https://www.youtube.com/watch?v=htjwtnjQkkE) |
| NodeInfo broadcast interval | `10800` (3 hours) | |
Most users should use these settings for their everyday carry (EDC) nodes.

### Position
### Radio & LoRa

| Option | Recommended Config | Notes |
| --------------------------: | :------------------- | :---------------------------------------------- |
| Smart position enabled | `True` | |
| Position broadcast interval | `3600` (1 hour) | |
| GPS update interval | `900` (15 minutes) | |
| Position flags | Disable unused flags | Fixed nodes should disable almost all of these. |
| **Option** | **Recommended Config** | **Notes** |
| :--- | :--- | :--- |
| **Device Role** | `CLIENT` or `CLIENT_MUTE` | Use `CLIENT_MUTE` unless you have a specific need to retransmit. |
| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. |
| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). |
| **NodeInfo Interval** | `10800` (3 hours) | |
| **Hop Limit** | `5` | Please do not set this higher than `6`. 🙏 |
| **Ignore MQTT** | `True` | Prevents misconfigured nodes from spamming you. |
| **OK to MQTT** | `True` | Allows you to see your node on [view.MtnMe.sh](https://view.mtnme.sh). |

### LoRa
### Position & Telemetry

!!! warning
As of October 1, 2025, Mountain Mesh members flipped their nodes over to the MediumFast modem preset. For more information, see the [MediumFast Migration Page](/mediumfast)
| **Option** | **Recommended Config** | **Notes** |
| :--- | :--- | :--- |
| **Smart Position** | `True` | Updates more frequently while you are moving. |
| **Smart Interval** | `15 minutes` | The fastest positions updates go out based on time |
| **Smart Distance** | `1 kilometer` | The minimum amount of distance required to re-transmit your position |
| **Broadcast Interval** | `10800` (3 hours) | Base interval when stationary. |
| **Fixed Position** | `False` | Mobile nodes should use GPS/Phone location. |
| **Device Metrics** | `Disabled` | Others on the mesh don't need to know your battery level. |
| **Env. Metrics** | `Disabled` | Not useful for mobile nodes. |

| Option | Recommended Config | Notes |
| -------------: | :----------------- | :----------------------------------------------------------------------------------------------- |
| Modem Preset | MEDIUM_FAST | This is the new fast network |
| ^^Hop limit^^ | `5` | Please do not set this higher than `6`. :pray: |
| Frequency Slot | 45 | This is the default. It equates to 913.125 MHz |
| Ignore MQTT | `True` | This is enabled on most `ROUTER` nodes in our mesh. |
| OK to MQTT | `True` | Added in `2.5.0`. Enable to show up on online tools like [view.MtnMe.sh](https://view.mtnme.sh). |
---

## 🏠 2. Personal/Local Infrastructure

## Module configuration
*For home base stations, attic nodes, backyard masts, and medium-height regional solar deployments.*

### Telemetry
As these nodes are stationary and always online, they don't need to be "chatty" about their location or status.

Please only enable on solar nodes where health data is useful.
### Radio & LoRa

| Option | Recommended Config | Notes |
| ----------------------------------: | :----------------- | :--------------------------------------------------------- |
| Device metrics update interval | `3600` (1 hour) | Change to `1800` when testing new nodes. |
| Environment metrics update interval | `3600` (1 hour) | |
| Power metrics module enabled | `False` | This is for I²C power monitors, not onboard battery stats. |
| **Option** | **Recommended Config** | **Notes** |
| :--- | :--- | :--- |
| **Device Role** | `CLIENT` or `CLIENT_BASE` | `CLIENT_BASE` helps ensure your EDC node messages get out. |
| **Is Un-Messagable** | `True` | Set on non-monitored nodes to prevents users from sending DMs and getting frustrated. |
| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. |
| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). |
| **NodeInfo Interval** | `21600` (6 hours) | Stationary nodes don't change info frequently. |
| **Hop Limit** | `3` | High hop count isn’t useful as not typically a messaged node |
| **Ignore MQTT** | `True` | Protects the mesh from internet flooding. |
| **OK to MQTT** | `True` | Allows monitoring the node from the MtnMesh web tools and helps with mesh coordination |

Consider disabling the `Environment metrics` / `Air Quality metrics` modules if you are not using the data.
### Position & Telemetry

| **Option** | **Recommended Config** | **Notes** |
| :--- | :--- | :--- |
| **Smart Position** | `False` | These aren’t moving, not needed. |
| **Broadcast Interval** | `21600` (6 hours) | It’s stationary; no need to reminded people that every hour. |
| **Fixed Position** | `True` | Manually set coordinates in the app if no hardware GPS. |
| **Device Metrics** | `10800` (3 hours) | Only for solar nodes, otherwise disable. |
| **Env. Metrics** | `10800` (3 hours) | Only if equipped; Used to checking for enclosure leaks or overheating, otherwise disable. |

### Neighbor Info
---

| Option | Recommended Config |
| --------------------: | :----------------- |
| Neighbor Info enabled | `False` |
## 🏔️ 3. Coordinated Public Infrastructure

Neighbor Info's functionality has been greatly limited in newer firmware versions. We recommend disabling it for most deployments.
*For high-sites moving messages across the state. These are generally ham towers on actual mountains.*

**Note:** Only coordinated infrastructure nodes should use the `ROUTER` role. Improperly configured routers can cause network-wide degradation. Please join the [Discord](https://discord.gg/4WN32RHGSs) to discuss your site before using these settings.

### Radio & LoRa

| **Option** | **Recommended Config** | **Notes** |
| :--- | :--- | :--- |
| **Device Role** | `ROUTER_LATE` | Better for mesh health 95% of the time than `ROUTER`. |
| **Modem Preset** | `MEDIUM_FAST` | Updated Oct 1, 2025. This is the new standard in N.GA. |
| **Frequency Slot** | `45` | Mediumfast Default (913.125 MHz). |
| **NodeInfo Interval** | `21600` (6 hours) | High-sites are constant; minimal updates needed. |
| **Rebroadcast Mode** | `CORE_PORTNUMS_ONLY` | Filters out non-essential traffic (e.g., ATAK and range test). |
| **Hop Limit** | `3` | Prevents telemetry from propagating further than useful |
| **Ignore MQTT** | `True` | **Crucial:** Protects the mesh from internet flooding. |
| **OK to MQTT** | `True` | Allows monitoring the node from the MtnMesh web tools and helps with mesh coordination. |

### Position & Telemetry

| **Option** | **Recommended Config** | **Notes** |
| :--- | :--- | :--- |
| **Smart Position** | `False` | Stationary high-site. |
| **Broadcast Interval** | `21600` (6 hours) | Stationary; updates every 6 hours is plenty. |
| **Fixed Position** | `True` | Manually set coordinates in the app if no hardware GPS. |
| **Device Metrics** | `10800` (3 hours) | Monitoring solar and mesh health. |
| **Env. Metrics** | `10800` (3 hours) | Only if equipped; Used to checking for enclosure leaks or overheating, otherwise disable. |

---

## Why these settings matter?

The Meshtastic network operates on a shared channel with roughly **3kbps** of usable bandwidth under MediumFast and just **1kbps** under LongFast. "Chatty" nodes—those sending updates more than necessary—can quickly saturate the network, preventing actual messages from getting through. By increasing intervals and limiting hops, we ensure the mesh remains usable for everyone.
102 changes: 0 additions & 102 deletions docs/config_new.md

This file was deleted.