Meshtastic Guide - Meshtastic Initial Configuration

Clients that Are Supported by Connection Type

Based on your connection, certain configuration options may not be fully supported. Discover which client is best for your type of connection.

Serial

Python CLI
Web Client
Android App

Bluetooth

Android App
Web Client

Configure Regional Settings

To begin communicating over the mesh, you need to configure your region. This setting determines the frequency range used by your device and should be adjusted based on your geographical location.

Android

Follow the installation and usage instructions for the Meshtastic Android app.
Open the app and connect your phone to the device using USB Serial or Bluetooth.
Once paired, click "UNSET" next to the device name.
Select the region from the list based on your geographical location.

Apple

You can configure the Region, Modem Preset, and Hop Limit on iOS, iPadOS, and macOS by navigating to Settings > Radio Configuration > LoRa.

CLI

Install Meshtastic PythonCLI

pip3 install --upgrade pytap2 pip3 install --upgrade meshtastic

Execute the following command, substituting <REGION-CODE> with the appropriate region code mentioned above based on your geographical location.

meshtastic --set lora.region <REGION-CODE>

Web

Open the Meshtastic Web interface at client.meshtastic.org.
Go to the LoRa menu.
In the Regional Settings, set your Region based on your geographical location.
Click Save.

Region Codes

Region Code	Description	Frequency Range (MHz)	Duty Cycle (%)	Power Limit (dBm)
UNSET	Unset	N/A	N/A	N/A
US	United States	902.0 - 928.0	100	30
EU_433	European Union 433MHz	433.0 - 434.0	10	12
EU_868	European Union 868MHz	869.4 - 869.65	10	27
CN	China	470.0 - 510.0	100	19
JP	Japan	920.8 - 927.8	100	16
ANZ	Australia & New Zealand	915.0 - 928.0	100	30
KR	Korea	920.0 - 923.0	100
TW	Taiwan	920.0 - 925.0	100	27
RU	Russia	868.7 - 869.2	100	20
IN	India	865.0 - 867.0	100	30
NZ_865	New Zealand 865MHz	864.0 - 868.0	100	36
TH	Thailand	920.0 - 925.0	100	16
UA_433	Ukraine 433MHz	433.0 - 434.7	10	10
UA_868	Ukraine 868MHz	868.0 - 868.6	1	14
MY_433	Malaysia 433MHz	433.0 - 435.0	100	20
MY_919	Malaysia 919MHz	919.0 - 924.0	100	27
SG_923	Singapore 923MHz	917.0 - 925.0	100	20
LORA_24	2.4 GHz band worldwide	2400.0 - 2483.5	100	10

NOTE: EU_433 and EU_868 must comply with an hourly duty cycle limitation of 10%, calculated every minute on a continuous 1-hour basis. Your device will cease transmission if you reach this limit until you are permitted to transmit again.

For a more detailed list, please refer to the LoRa Region by Country.