First Steps After Getting Hardware

You have your device. Here is how to go from unboxed hardware to sending your first message on your local mesh network.

Before you start - attach the antenna first. Screw the antenna on before you power the device for testing. Never transmit with no antenna connected: transmitting into no load can damage the radio's power amplifier.

Step 1: Find Out What's in Your Area

Before flashing firmware, check whether there is an existing network near you. Joining an existing network is much more useful than operating a single isolated node.

• Meshtastic network map: meshmap.net - shows active Meshtastic nodes worldwide. Note: only nodes bridged to the official MQTT server appear, so an empty map does not mean there is no local mesh - most nodes never connect to MQTT.
• MeshCore network map: map.meshcore.dev - shows active MeshCore nodes

If you see nodes in your area, great - you can join them. If not, you may be starting a network from scratch in your area, which just means you'll be the first node.

Step 2: Find Your Local Channel / Preset

For your messages to reach other nodes, your device must be on the same channel and preset as the local network. This is a very common reason new users cannot communicate with nearby nodes.

Find out what your local network uses:

• Check the Meshtastic Discord or local Meshtastic groups for your region's channel settings
• Check the MeshCore Discord for MeshCore regional settings
• Look for local mesh groups on Reddit, Facebook, or community forums for your city or region

If you cannot find specific local settings, most US networks default to the LongFast preset for Meshtastic or the default regional preset for MeshCore - but verify with your local community.

Step 3: Flash the Firmware

Use the official web-based flashers - no software installation required (Chrome/Edge recommended):

• Meshtastic: flasher.meshtastic.org
• MeshCore: flasher.meshcore.io

Process:

1. Make sure the antenna is attached (see the warning above), then connect your device via USB data cable
2. Open the flasher in Chrome or Edge
3. Select your device from the list
4. MeshCore only: choose a firmware variant - Companion for personal handheld use, Repeater for a fixed infrastructure relay node, or Room Server for a shared message board. (Meshtastic has no firmware-variant choice here; you set the node's role in the app after flashing - see Step 4.)
5. Click Flash and wait for completion (typically 1 - 3 minutes)

Troubleshooting if your device doesn't appear:

• Try a different USB cable - charge-only cables are one of the most common causes of this problem
• Try a different USB port on your computer
• On Windows: install CH340 or CP2102 drivers if prompted (or if the port isn't detected)
• Force bootloader mode manually: for ESP32 devices, hold the BOOT button while plugging in USB; for nRF52 devices, double-tap the reset button to enter DFU mode

Step 4: Initial Configuration

After flashing, open the app (Meshtastic or MeshCore) on your phone and connect via Bluetooth. You'll need to configure a few basic settings:

1. Set your region: Select US (or your region). This sets the correct frequency band. This is required before the radio will transmit. (Confirm the antenna is attached before the radio starts transmitting.)
2. Set your name: A short display name so others can see who you are on the network.
3. Set your channel/preset: Match the settings used by your local network (from Step 2). If you're starting fresh, leave at the default.
4. Optional - set your role: For a personal device: Client. For a dedicated relay: Router or Repeater.

Step 5: Test

Once configured:

• Send a message to the default channel. If other nodes are in range, they will receive it.
• Check the node list in the app - you should see yourself, and any nearby nodes that have been active recently.
• If you have a second device or a friend with a device, test direct messaging.

Step 6: Join the Community

The mesh communities are active and helpful for new users:

• Meshtastic Discord: discord.gg/meshtastic - large global community, many regional channels
• MeshCore Discord: discord.gg/meshcore
• Reddit: r/meshtastic for Meshtastic discussions

Local mesh groups often coordinate channel settings, share coverage maps, and organize repeater placement - worth finding yours.

Quick Reference: Common First-Time Issues

Problem	Most Likely Cause	Fix
Device not recognized by flasher	Charge-only USB cable	Use a data cable; try BOOT button trick
Cannot connect via Bluetooth	Device not paired / app not seeing device	Restart app; check device is powered on; re-pair
No other nodes visible	Wrong channel preset, or no nearby nodes	Confirm channel matches local network; check meshmap.net
Messages not received by others	Region not set / wrong frequency	Confirm region is set to US (or your region) in app
Short range	Stock antenna, obstructions	Upgrade antenna; increase elevation if possible