Initial Configuration

Supported Clients per Connection Type

Depending on your connection, some configuration options are not fully supported. Find out which client is best for your type of connection.

Serial

Serial

• Python CLI
• Web Client
• Android App

Bluetooth

Bluetooth

• Android App
• Web Client

Network

Network

info

Connecting over network is only supported on ESP32 devices.

• Web Client
• Android App
• iOS App
• Python CLI

Set Regional Settings

In order to start communicating over the mesh, you must set your region. This setting controls which frequency range your device uses and should be set according to your regional location.

Android

Android

1. Follow the installation and usage instructions for Meshtastic Android.
2. Open the app, connect to the device from your phone over USB Serial or Bluetooth.
3. Once paired, Click "UNSET" next to the device name.
4. Select the region from the list according to your regional location.

Apple

Apple

info

Configuration of Region, Modem Preset and Hop Limit is available on iOS, iPadOS and macOS at Settings > Radio Configuration > LoRa.

CLI

CLI

1. Install Meshtastic PythonCLI

   pip3 install --upgrade pytap2
   pip3 install --upgrade meshtastic
2. Run the following command, replacing <REGION-CODE> with the region code listed above according to your regional location.

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

Web

Web

1. Open the Meshtastic Web interface: client.meshtastic.org
2. Navigate to the LoRa menu.
3. Under Regional Settings, set your Region according to your regional location.
4. 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

info

EU_433 and EU_868 have to adhere to an hourly duty cycle limitation of 10%, calculated every minute on a rolling 1-hour basis. Your device will stop transmitting if you reach it, until it is allowed again.

Refer to LoRa Region by Country for a more comprehensive list.

Continue Configuration

Now that you have set the LoRa region on your device, you can continue with configuring any additional configs to suit your needs.

Device Configuration