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
- Bluetooth
- Network
Connecting over network is only supported on ESP32 devices.
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
- Apple
- CLI
- Web
- Follow the installation and usage instructions for Meshtastic Android.
- Open the app, connect to the device from your phone over USB Serial or Bluetooth.
- Once paired, Click "UNSET" next to the device name.
- Select the region from the list according to your regional location.
Configuration of Region, Modem Preset and Hop Limit is available on iOS, iPadOS and macOS at Settings > Radio Configuration > LoRa.
- Install Meshtastic PythonCLI
pip3 install --upgrade pytap2
pip3 install --upgrade meshtastic - Run the following command, replacing
<REGION-CODE>
with the region code listed above according to your regional location.meshtastic --set lora.region <REGION-CODE>
- Open the Meshtastic Web interface: client.meshtastic.org
- Navigate to the LoRa menu.
- Under Regional Settings, set your Region according to your regional location.
- Click Save.
Region Codes​
Region Code | Description |
---|---|
UNSET | Unset |
US | United States |
EU_433 | European Union 433MHz |
EU_868 | European Union 868MHz |
CN | China |
JP | Japan |
ANZ | Australia & New Zealand |
KR | Korea |
TW | Taiwan |
RU | Russia |
IN | India |
NZ_865 | New Zealand 865MHz |
UA_433 | Ukraine 433MHz |
UA_868 | Ukraine 868MHz |
TH | Thailand |
LORA_24 | 2.4 GHz band worldwide |
EU_433 and EU_868 have to adhere to an hourly duty cycle limitation of 10%. Your device will stop transmitting if you reach it, until it is allowed again.
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.