Reference
Configuration references and advanced guides for Meshtastic
These pages provide detailed reference information for Meshtastic node configuration and advanced features.
Configuration Reference Guides
1 - Node Configuration Reference
Complete reference for Meshtastic node configuration options
This page provides a comprehensive reference of all node configuration options recommended for the Indiana Hoosier Mesh network.
LoRa Settings
| Option | Setting |
|---|
| Region | US Region 915 |
| Use Preset | ON |
| Preset | Long Range - Fast |
| Ignore MQTT | OFF |
| OK to MQTT | ON |
| Transmit Enabled | ON |
| Number of Hops | 5 |
| Frequency Slot | 20 |
| RX Boost Gain | ON |
| Frequency Override | 906.875 |
| Transmit Power | 30 |
Channel Settings
| Option | Setting |
|---|
| Channel Name | Long Fast |
| PSK | AQ== |
| Uplink Enabled | ON |
| Downlink Enabled | ON |
| Position Enabled | ON |
| Precise Location | OFF |
| Distance Slider | 148 ft |
Security Settings
| Option | Setting |
|---|
| Direct Message Key (Public) | Populated* |
| Direct Message Key (Private) | Populated* |
| Log Serial Console | ON |
| Debug Log API | OFF |
| Admin Managed Mode | OFF |
| Legacy Admin Channel | OFF |
*Note: Unique to each node
User Configuration
| Option | Setting |
|---|
| Node ID | Populated |
| Long Name | Your Choice |
| Short Name | Your Choice (max 4 characters) |
| Hardware Model | Populated |
| Unmessageable | OFF (Optional ON for roof nodes) |
| Licensed Amateur Radio | OFF* |
Important: Meshtastic allows encrypted transmissions. However, US Amateur Radio licensing prohibits encryption. See FCC guidelines and our Amateur Radio & Meshtastic guide for complete details.
Device Settings
| Option | Setting |
|---|
| Device Role | CLIENT |
| Rebroadcast Mode | All |
| Node Info Broadcast Interval | Three Hours |
| LED Heartbeat | ON |
| Time Zone | Phone or GMT-5 |
| Button GPIO | 0 |
| Buzzer GPIO | 0 |
Device Role Notes
- CLIENT (default): Standard mesh participant
- CLIENT_BASE: Use for roof/attic-based nodes. Don’t forget to favorite your local owned nodes
- ROUTER / ROUTER_LATE: Avoid unless on a very tall tower. Check with experienced RF operators on the Indiana Mesh Discord before using these roles
Position Settings
| Option | Setting |
|---|
| Broadcast Interval | Six Hours |
| Smart Position | OFF |
| Fixed Position Lat | User Defined (via phone) |
| Fixed Position Long | User Defined (via phone) |
| Position Flags | 3 – User Defined |
| GPS Receive GPIO | Pin 0 |
| GPS Transmit GPIO | Pin 0 |
| GPS EN GPIO | Pin 0 |
| Altitude | Enabled |
| Altitude MSL | Enabled |
Serial Settings (Optional)
| Option | Setting |
|---|
| Serial Enabled | ON |
| Echo Enabled | OFF |
| RX | 0 |
| TX | 0 |
| Baud Rate | BAUD_DEFAULT |
| Timeout | 0 |
2 - Advanced Configuration - MQTT & Telemetry
MQTT, Serial, and Telemetry configuration for Meshtastic nodes
This page covers advanced configuration options for MQTT (internet connectivity), Serial interfaces, and Telemetry collection.
MQTT (Optional but Recommended)
MQTT allows you to access and control your Meshtastic nodes over the internet, integrating them with other services and creating mesh monitors.
MQTT Configuration
| Option | Setting |
|---|
| MQTT Enabled | OFF (optional ON) |
| Address | mqtt.meshtastic.org |
| Username | meshdev |
| Password | User Defined |
| Encryption Enabled | ON |
| JSON Output | OFF |
| TLS Enabled | ON |
| MQTT Root Topic | msh/US/IN |
Important MQTT Considerations
Network Overload Warning
When you enable MQTT, you’ll receive messages from many nodes across the network and can become overwhelmed with traffic. Use this feature deliberately and carefully.
Best Practices:
- Use MeshMap.net to check specific root topics of users in your area before enabling MQTT
- Consider the impact on your device’s performance and battery life
- Start with MQTT disabled and enable only when needed
- Monitor your device’s resource usage after enabling MQTT
Finding Your Root Topic
Check MeshMap.net to see what root topics other users in your region are publishing to. This will help you understand the network topology and choose an appropriate topic for your node.
Telemetry (Optional)
Telemetry allows your node to collect and broadcast device metrics like temperature, humidity, battery status, and GPS location.
| Option | Setting |
|---|
| Send Device Telemetry | OFF |
| Environment Metrics Module | OFF |
| Environment Metrics Update Interval | OFF |
| Environment Metrics On Screen | OFF |
When to Enable Telemetry
- Enabled by default on devices with environmental sensors
- Useful for nodes you want to monitor remotely via MQTT
- Increases power consumption on battery-powered devices
- Consider your use case before enabling
Serial/USB Configuration (Optional)
The Serial interface allows you to communicate with your Meshtastic device via USB or serial connection for advanced debugging and integration with external systems.
| Option | Setting |
|---|
| Serial Enabled | ON |
| Echo Enabled | OFF |
| RX | 0 |
| TX | 0 |
| Baud Rate | BAUD_DEFAULT |
| Timeout | 0 |
Use Cases
- Debug and monitor device behavior via serial port
- Integrate with external applications or sensors
- Advanced troubleshooting of device issues
- Integration with automations or home assistant systems
External Notifications (Optional)
Configure how your device alerts you to incoming messages.
| Option | Setting |
|---|
| External Notification Enabled | OFF |
| Alert message LED | ON |
| Alert message buzzer | OFF |
| Alert message vibration | OFF |
| Alert bell LED | OFF |
| Alert bell buzzer | OFF |
| Alert bell vibration | OFF |
These settings allow you to customize notification behavior based on message type and your preferences.
3 - Amateur Radio & Meshtastic
Information for licensed amateur radio operators using Meshtastic
Information for licensed amateur radio (ham) operators using Meshtastic devices. Understanding the legal and technical considerations is essential for compliant operation.
Important: Encryption & Licensing
Critical for Ham Operators
US Amateur Radio licensing specifically prohibits encryption of transmitted information. While Meshtastic supports encrypted communications, licensed amateur radio operators must disable encryption when operating under their amateur radio license.
See FCC Part 97 Rules for complete regulations.
Educational Presentations
Meshtastic Overview for Amateur Radio
🎥 Meshtastic Overview Presentation - Community presentation on Meshtastic fundamentals and usage (slides)
FCC/Licensing Compliance
For a comprehensive overview of Meshtastic specifically for amateur radio operators, including legal considerations, technical details, and best practices:
📊 Meshtastic for Amateur Radio Operators - Google Slides Presentation
This presentation covers:
- FCC Part 97 regulations and compliance
- Encryption restrictions for ham operators
- Power output considerations
- Frequency allocations
- Proper station identification
- Technical configurations for licensed operation
Configuration for Licensed Operation
When operating under an amateur radio license, configure your Meshtastic device as follows:
User Configuration
In your node’s User Configuration settings:
| Setting | Value | Reason |
|---|
| Licensed Amateur Radio | ON | Enables ham radio mode |
| Long Name | Include callsign | Station identification (e.g., “KC1XXX - Josh”) |
Channel Configuration
Encryption Must Be Disabled
Default Meshtastic channels use encryption (PSK: AQ==). For ham operation, you must configure an unencrypted channel.
- PSK (Pre-Shared Key): Must be set to a default/empty value for no encryption
- Consider creating a separate channel for ham-only communications
Power & Frequency Considerations
Transmit Power
- Unlicensed: Limited to 1 watt EIRP (Effective Isotropic Radiated Power) on ISM bands
- Licensed: May use higher power levels within amateur radio band limits (check local regulations)
- Configure appropriately in LoRa settings based on your license class
Frequency Bands
- ISM Band (915 MHz): Available for both licensed and unlicensed use
- Amateur Allocations: Consult your local amateur radio band plan
- Ensure your device is configured for legal frequencies in your region
Station Identification
Per FCC Part 97.119:
- Station identification is required at the end of each communication and at least every 10 minutes during communication
- Include your callsign in your node’s Long Name for automatic identification
- Consider periodic position beacons to meet ID requirements
Power Output & EIRP
Understanding EIRP
Effective Isotropic Radiated Power (EIRP) = Transmitter Power + Antenna Gain - Cable Loss
Power Limits
- Part 15 (Unlicensed): 1 watt EIRP maximum
- Part 97 (Amateur): Varies by band and license class
- Technician: Check specific band limits
- General/Extra: Higher power privileges on most bands
Example Calculation
Transmitter: 30 dBm (1 watt)
Antenna Gain: +3 dBi
Cable Loss: -0.5 dB
EIRP = 30 + 3 - 0.5 = 32.5 dBm (≈1.78 watts)
For unlicensed operation, this would exceed the 1-watt EIRP limit.
Best Practices for Ham Operators
- Clearly mark licensed operation - Use callsign in node name
- Document your configuration - Note power levels, antenna specs, and EIRP calculations
- Separate licensed/unlicensed operation - Consider different devices or channels
- Join the community - Connect with other ham operators on Indiana Mesh Discord
- Stay current - FCC rules and interpretations can evolve
High-Power Station Options
For licensed operators seeking high-power operation:
- B&Q Station G2 - High-power licensed station designed for amateur radio use
- Custom Builds - Many operators build custom high-power stations with external amplifiers
Reminder
Always ensure your configuration complies with your license class privileges and local regulations. When in doubt, consult with your local amateur radio club or the ARRL.
Additional Resources
Questions?
Have questions about operating Meshtastic under your amateur radio license? Ask on the Indiana Mesh Discord where experienced ham operators can help guide you.