Initial Node Configuration Checklist

When you get a new Meshtastic node, running through a standard configuration checklist ensures it's properly set up for your network before deployment. This guide covers every setting that matters for a production deployment.

Step 1: Flash Latest Stable Firmware

Even brand-new hardware may ship with outdated firmware. Always flash the latest stable release before configuration:

1. Visit flasher.meshtastic.org in Chrome or Edge
2. Connect node via USB
3. Select your board model exactly (wrong board = failed flash)
4. Select "Latest Release" and click Flash
5. Wait for flash to complete (1-3 minutes)

Step 2: Region Setting (Critical)

The region setting controls which frequency band the node uses. Transmitting on the wrong frequency is illegal and will cause your node to interfere with other services:

# For US users:
meshtastic --set lora.region US

# For Canada:
meshtastic --set lora.region TW  # Canada uses US915 band

# Check current setting:
meshtastic --get lora.region

The node will not transmit until a region is set. This is intentional — it prevents out-of-box interference.

Step 3: Set Your Identity

# Set your long name (visible to all nearby nodes):
meshtastic --set-owner "Your Name or Node Name"

# Set your short name (4 chars, shown on map):
meshtastic --set-owner-short "AB01"

Step 4: Configure Your Channel

To join an existing community network, scan their QR code with the Meshtastic app or enter the channel settings manually:

# Set channel name and key (replace with your community's values):
meshtastic --ch-index 0 --ch-set name "CommunityName"
meshtastic --ch-index 0 --ch-set psk "base64encodedkey=="

# Verify channel settings:
meshtastic --info

Step 5: Set Device Role

# For a personal/portable node:
meshtastic --set device.role CLIENT

# For a fixed home station that also relays traffic:
meshtastic --set device.role ROUTER_CLIENT

# For a dedicated infrastructure repeater:
meshtastic --set device.role ROUTER

Step 6: Configure GPS (if equipped)

# Enable GPS position broadcasting:
meshtastic --set position.gps_enabled true

# Set position broadcast interval (seconds):
# 900 = every 15 minutes (good for fixed nodes)
# 60 = every minute (for mobile use)
meshtastic --set position.position_broadcast_secs 900

# For fixed installations, set a fixed position instead of using GPS:
meshtastic --setlat 45.5051 --setlon -122.6750 --setalt 50

Step 7: Verify and Test

# Show full device info:
meshtastic --info

# Listen for incoming packets:
meshtastic --listen

# Send a test message:
meshtastic --sendtext "Test from [your name]"

Check that your node appears in the app's node list and that the channel matches your community's configuration. Send a test message and verify it's received by another node.