Getting Your First Message Through: Meshtastic

This guide will take you from zero to sending a LoRa mesh message on Meshtastic, step by step. No prior RF or networking experience is required. If you get stuck, the What to Check sections at the end will help you diagnose the most common problems.

Step 1: Buy the Right Hardware

You need a LoRa development board with the Meshtastic firmware flashed onto it. The two most popular beginner choices are:

• LILYGO T-Beam (v1.1 or v1.2) - a combined LoRa radio, GPS module, and ESP32 microcontroller with an 18650 battery holder. It is the classic Meshtastic node. Costs $25 - 40 on AliExpress or Amazon.
• Heltec LoRa 32 v3 - a compact board with a small built-in OLED display, LoRa radio, and ESP32. No built-in GPS, but lighter and cheaper ($20 - 25). A good choice if you want a pocket-sized node.

Make sure the board you buy is rated for 915 MHz (for the USA). This should say "915MHz" or "US915" in the product listing. A 868 MHz EU version will not work on US community meshes.

You also need a short USB cable (usually USB-C or micro-USB depending on the board) to connect the device to your computer for flashing.

Step 2: Flash the Meshtastic Firmware

Meshtastic provides a web-based flashing tool so you do not need to install any software.

1. Open Google Chrome or Microsoft Edge (the tool requires a browser with Web Serial support, and Chrome or Edge is what the Meshtastic project recommends). Desktop Firefox added Web Serial support in version 151 (2026), but the Meshtastic project does not yet recommend it; Safari does not support Web Serial at all.
2. Go to flasher.meshtastic.org.
3. Connect your LoRa board to your computer with the USB cable.
4. Click Get Started. The site will prompt you to select a serial port - choose the one that appeared when you plugged in your device (usually labeled "USB Serial" or "CP210x" or "CH9102").
5. Select your device model from the dropdown list.
6. Click Flash. The tool will download the latest stable firmware and write it to the device. This usually takes a minute or two.
7. When flashing is complete, the device will reboot automatically. You should see the Meshtastic boot screen on the OLED display (if your board has one) or a blinking LED.

If the serial port does not appear, you may need to install a USB-to-serial driver for your board's USB chip. Recent LILYGO T-Beams use a WCH CH9102 chip (install the WCH driver; some early units used a CP2104). The Heltec v3 uses a Silicon Labs CP2102 chip (install the Silicon Labs CP210x driver). Search for the chip name + "driver" to find the official installer.

Step 3: Install the Meshtastic App

Meshtastic is controlled through a phone app that communicates with the node over Bluetooth or Wi-Fi.

• Android: install Meshtastic from the Google Play Store (it is free and open source).
• iPhone / iPad: install Meshtastic from the Apple App Store.

There is also a web-based client at client.meshtastic.org if you prefer to manage the node from your computer.

Step 4: Pair via Bluetooth

1. Open the Meshtastic app and tap the + button to add a new device.
2. The app will scan for nearby Bluetooth devices. Your node should appear, named something like "Meshtastic_XXXX" (where XXXX is a short ID derived from your device's MAC address).
3. Tap on it. The app will prompt you for a pairing PIN. Look at the OLED display on your node - the PIN is shown there. Enter it in the app.
4. Once paired, the app will sync with the device and show you the main interface: a map, a messages tab, and a node list.

Step 5: Configure Your Region and Channel

Before the radio will transmit, you must set your region:

1. In the app, go to the device configuration (the wrench/gear icon).
2. Find LoRa Config → Region and set it to US.
3. Tap Save (or the checkmark). The device will reboot briefly.

By default, Meshtastic uses the LongFast channel, which is the standard public channel used by community meshes across the US. Leave it on LongFast for now.

Step 6: Send Your First Message

1. Tap the Messages tab in the app.
2. Tap Primary Channel (or the LongFast channel name).
3. Type a message in the text box at the bottom and hit Send.

Your node will transmit the message over LoRa. If you are alone and there are no other Meshtastic nodes within range, the message will still appear in your chat history - it was sent, but there was no one to receive it. To verify two-way communication, you need either a second node or a nearby community mesh member.

With only a single node there is no way to send a message "to yourself" over the radio - the app and the node are the same endpoint, so nothing meaningful is transmitted or received over RF, and Meshtastic acknowledgments come from another node rebroadcasting or a recipient ACKing, never from a node hearing its own transmission. To sanity-check a single isolated node, instead confirm that the region is set, watch the channel-utilization / airtime statistics in the app to see the radio is active, and look for any nearby community node to appear in the node list. A genuine end-to-end radio test requires a second device or a nearby mesh member.

Step 7: Join the LongFast Channel

The LongFast channel is the default public channel. If there are other Meshtastic users within a few kilometers (or connected through relay nodes), your messages will reach them and theirs will reach you. The node list in the app will show you who is currently visible on the mesh.

What to Check If Nothing Works

The serial port never appeared in the flasher

Install the USB-to-serial driver for your board's chip: the CH9102 (WCH driver) for recent T-Beams, or the CP210x (Silicon Labs driver) for the Heltec v3 and older T-Beams. On Windows, check Device Manager for a yellow warning icon on an unknown USB device.

Flashing failed with an error

Some boards need to be put into "bootloader mode" before flashing. Hold the BOOT button while pressing RESET (or while plugging in the USB cable). Then try flashing again.

The Bluetooth device doesn't appear in the app

Grant the app its requested Bluetooth permissions (on Android 11 and earlier, Location permission was also required for BLE scanning; on Android 12 and later, scanning uses the BLUETOOTH_SCAN permission and Location is not inherently required). The app may still ask for Location for position features. Try toggling your phone's Bluetooth off and back on.

Messages show "Waiting to send" indefinitely

The region is not set. Go to LoRa Config and set it to US. The radio will not transmit until a region is configured.

Messages sent but no acknowledgement received

This is normal if you are alone on the mesh - there is no one to acknowledge. Try moving outdoors and away from buildings for better range. Check meshmap.net (next chapter) to see if there are community nodes near you.