rocket_launch Quick Start Guide

Getting Started with MeshCore

Step-by-step guide to set up your MeshCore device: flash firmware, install the companion app, configure EU settings, and send your first message.

From Unboxing to First Message

This guide walks you through setting up a MeshCore device from scratch. No prior experience with LoRa or mesh networking is required. The entire process takes approximately 15 to 30 minutes.

01

Choose and Buy a Device

schedule 5 minutes

If you have not yet purchased a device, visit our device guide to find the right one for your needs. For your first device, we recommend starting with a phone companion setup, which pairs a LoRa device with the MeshCore App on your smartphone.

Popular first devices include the Heltec V3, LilyGo T-Beam, and RAK WisBlock Starter Kit.

02

Unbox and Attach the Antenna

schedule 2 minutes

When your device arrives:

  1. Open the package and identify the device board and the antenna.
  2. Attach the antenna before powering on the device. This is important: transmitting without an antenna can damage the LoRa radio chip.
  3. Screw the antenna onto the SMA or RP-SMA connector on the device. Hand-tighten only; do not use pliers.

SMA vs RP-SMA: These are two different antenna connector types that look nearly identical. Check your device documentation to confirm which type your device uses. If your antenna does not screw on smoothly, you may have the wrong connector type. Adapters are available for a few euros.

03

Flash MeshCore Firmware

schedule 5 minutes

MeshCore firmware is installed through a web-based flasher. You need a computer with a Chrome or Edge browser (Firefox does not support WebSerial).

  1. Go to flasher.meshcore.co.uk
  2. Connect your device to your computer using a USB cable.
  3. Select your device model from the list.
  4. Select the firmware variant:
    • Companion Radio if you will pair with a phone
    • Standalone if you will use the device on its own with its built-in screen
    • Repeater if you are setting up a relay node
  5. Click “Flash” and wait for the process to complete.

If the flasher does not detect your device, you may need to install a USB driver:

  • CP210x driver for most Heltec and LilyGo devices: available from Silicon Labs
  • CH340/CH9102 driver for some clone boards: available from WCH
04

Install the MeshCore Companion App

schedule 3 minutes

Download the MeshCore App on your phone:

The app communicates with your device over Bluetooth and provides the interface for sending messages, joining rooms, and managing your device settings.

05

Pair Your Device

schedule 3 minutes
  1. Make sure Bluetooth is enabled on your phone.
  2. Power on your MeshCore device (antenna attached).
  3. Open the MeshCore App.
  4. The app will scan for nearby MeshCore devices. Select your device from the list.
  5. Confirm the pairing request if prompted.

Once paired, the app displays your device status and is ready to send and receive messages.

06

Configure EU Settings

schedule 2 minutes

Your device needs to be configured for the European frequency band. In the MeshCore App:

  1. Go to Settings (or Device Settings).
  2. Set the region preset to EU/UK (Narrow).
  3. Verify the following parameters:
    • Frequency: 869.618 MHz
    • Bandwidth: 62.5 kHz
    • Spreading Factor: 8
    • Coding Rate: 8

These are the standard settings used by the European MeshCore community. Using the same settings ensures your device can communicate with other nodes in the network.

07

Send Your First Message and Join a Room

schedule 5 minutes

You are now ready to communicate.

Send a direct message: If you can see another MeshCore device in your node list, select it and type a message. Direct messages are encrypted end-to-end.

Join a room server: Room servers are group communication hubs. In the MeshCore App:

  1. Go to the Rooms section.
  2. Browse available rooms or enter a room name that you know of.
  3. Join the room to start seeing group messages.

Check our community directory to find active room servers in your region.

Troubleshooting

I see no other nodes

This is normal if there are no MeshCore devices within radio range. Try the following:

  • Go outside. LoRa signals are significantly weaker through walls and buildings.
  • Move to higher ground. Elevation dramatically improves range. A balcony, rooftop, or hilltop can make the difference.
  • Check the coverage map to see if there are repeaters or active nodes near you.
  • Join your local community. Other operators can tell you where active nodes are and help you test your setup.
  • Be patient. If you are the first node in your area, you are pioneering. Consider deploying a repeater to start building local coverage.

The flasher does not detect my device

  • Try a different USB cable. This solves the problem in most cases.
  • Install the USB driver for your device (CP210x or CH340/CH9102).
  • Try a different USB port on your computer.
  • On Windows, check Device Manager to see if the device appears.

My device is not pairing with the app

  • Ensure the device is powered on and the antenna is attached.
  • Check that Bluetooth is enabled on your phone.
  • Make sure you flashed the Companion Radio firmware variant, not Standalone or Repeater.
  • Restart both the device and the app, then try again.

Messages are not being delivered

  • Verify that both devices are using the same frequency settings (EU/UK Narrow preset).
  • Check that you are within range. Start by testing with devices close together, then gradually increase distance.
  • Make sure the antenna is properly attached on both devices.

Next Steps

Back to top

Need Help?

Join a local community to get support from experienced operators, or browse our device catalog to find the right hardware.

Find Your Community Browse Devices