Switch Language

initial-config

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.

      <Icon icon="mdi:serial-port" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Serial
    </>
  ),
  value: "serial",
},
{
  label: (
    <>
      <Icon icon="mdi:bluetooth" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Bluetooth
    </>
  ),
  value: "ble",
},
{
  label: (
    <>
      <Icon icon="mdi:internet" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Network
    </>
  ),
  value: "windows",
},

]}>

Serial

Bluetooth

Network

:::info 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.

      <Icon icon="mdi:android" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Android
    </>
  ),
  value: "android",
},
{
  label: (
    <>
      <Icon icon="mdi:apple" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Apple
    </>
  ),
  value: "apple",
},
{
  label: (
    <>
      <Icon icon="mdi:terminal" height="1.5rem" style={{ marginRight: "0.25rem" }} /> CLI
    </>
  ),
  value: "cli",
},
{
  label: (
    <>
      <Icon icon="mdi:internet" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Web
    </>
  ),
  value: "web",
},

]}>

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

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

CLI

  1. Install Meshtastic PythonCLI sh 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. sh meshtastic --set lora.region <REGION-CODE>

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

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