Updating MeshCore Firmware

Update Frequency

MeshCore releases firmware periodically. Major releases introduce new features and architecture improvements; point releases fix bugs. Check the changelog at github.com/meshcore-dev/MeshCore/releases before updating to understand what has changed.

Checking Your Current Version

You can find your MeshCore firmware version in two ways:

• MeshCore app (Bluetooth): Connect to the node via the companion app and check the node info panel.
• Serial console: Connect via USB serial at 115200 baud. The device outputs its firmware version string on boot.

Update Methods

1. MeshCore Web Flasher (Easiest)

1. Open flasher.meshcore.co.uk in Chrome or Edge (WebSerial required).
2. Connect your device via USB.
3. Select your board and firmware variant (Repeater, Client, etc.).
4. Click Flash. The flasher downloads the latest release automatically.

This is the recommended method for most users. Ensure you select the correct variant for your node's role.

2. Manual Binary Flash

Download the appropriate binary from the GitHub releases page. The process differs by chip:

nRF52840 devices (RAK4631, Heltec T114, etc.)

These devices expose a USB mass storage drive when in bootloader mode (double-tap the reset button on most boards). Simply drag and drop the .uf2 file onto the drive. The device reboots automatically after the copy completes. No additional software required.

ESP32 devices

Use esptool.py from the command line, or use the web flasher. The web flasher is simpler for most users.

3. OTA (Not Yet Supported)

As of early 2026, MeshCore does not support over-the-air firmware updates. Physical access or USB connectivity is required for all firmware updates. Check the MeshCore release notes for updates to this capability in future releases.

Configuration After Update

MeshCore stores configuration in flash. Most updates preserve existing settings, but you should:

• Read the release notes for any breaking configuration changes before updating.
• After updating, connect to the node and verify your preset, channel key, and role settings are intact.
• If settings were reset, re-apply your configuration before returning the node to service.

Firmware Variants — Flash the Correct One

MeshCore ships multiple firmware variants for the same hardware, each tuned for a different node role:

• Repeater: Optimized for infrastructure repeater nodes. Disables unnecessary client features to reduce overhead.
• Client: For end-user devices with a connected app or screen.
• Other variants may exist depending on the release.

Important: If you accidentally flash Client firmware onto an infrastructure Repeater node, its behavior will change. Always double-check the variant selection before flashing a deployed node.