Skip to main content

Using Meshtastic Flasher


Make sure not to power the radio on without first attaching the antenna! You could damage the radio chip!


Meshtastic Flasher (aka m-flasher) is a graphical user interface for flashing supported devices with Meshtastic. The following operating systems are currently supported: Windows, Mac, and Ubuntu.


Verify python3 is installed

Check python3 version

Check python3 version
python3 --version
# If version is less than v3.6, please update python3
Install/Update `python3`
Install python3, pip, and venv
sudo apt update
sudo apt upgrade
sudo apt install -y python3 python3-pip python3-venv

Install App

Install using `pip`Note: The previous "single executable" installation option has been deprecated as of March 10, 2022.
Install Meshtastic Flasher
python3 --version
# ensure you are using at least python v3.6
# change to a directory where you want to create a python virtual environment
mkdir some_dir
cd some_dir
# if the following command fails, it might tell you what package to install
python3 -m venv venv
# activate the python virtual environment
source venv/bin/activate
# your prompt should change - it should include "(venv) in the front
# upgrade pip
pip install --upgrade pip
pip install meshtastic-flasher
Running Meshtastic Flasher

Flashing the Device

The Meshtastic Flasher will flash the latest firmware to esp32 and nrf52 devices. This is a newly developed application (as of February 1, 2022), so there may be some issues discovered as it is tested by users.

There are three steps:

  • Click the "GET VERSIONS" button to get the versions available (from GitHub).
  • Click the "DETECT DEVICE" button to determine the port and device variant connected.
  • Click the "FLASH" button to flash the version selected, using the port selected to the device.


If you run into an issue, please create a ticket here: Flasher Issues

The code can be found at the Meshtastic-gui-installer repo

Known limitations

The following are known limitations:

  • Raspberry Pi is not available, since it is arm-based and there are no pre-built libraries for PySide
  • Ubuntu 20.04 is the version used for testing, it may work with other versions
  • see README for more details