meshtastic/docs/configuration/index.mdx
tekstrand 9e9720fb21
Some checks failed
CI / quality (push) Has been cancelled
CI / build (push) Has been cancelled
reorder side navigation
2024-11-02 07:42:51 -05:00

76 lines
1.9 KiB
Plaintext

---
sidebar_label: Advanced Configuration
collapsible: true
sidebar_position: 5
id: configuration
title: Configuration
slug: /configuration
description: How to configure your Meshtastic device to get started
---
import LoRaRegions from "../blocks/_lora-regions.mdx";
import TabItem from "@theme/TabItem";
import Tabs from "@theme/Tabs";
## Select Region
To start communicating over the mesh, the only setting your must configure is your region. This controls the frequency range your device uses and should be set according to your regional location.
<Tabs
groupId="settings"
defaultValue="android"
values={[
{label: 'Android', value: 'android'},
{label: 'Apple', value: 'apple'},
{label: 'CLI', value: 'cli'},
{label: 'Web', value: 'web'},
]}>
<TabItem value="android">
#### Android
1. [Install the Android app](/docs/software/android/installation)
2. Connect to the device using Bluetooth or USB Serial.
3. Tap "UNSET" next to the device name.
4. Select the region
</TabItem>
<TabItem value="apple">
#### Apple
1. [Install the Apple app](/docs/software/apple/installation/)
2. Connect to the device using Bluetooth
3. If unset, tap "Set Region" or go to Settings > LoRa
</TabItem>
<TabItem value="cli">
#### CLI
1. [Install the Python CLI](/docs/software/python/cli/installation)
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>
```
</TabItem>
<TabItem value="web">
#### Web
1. Open the Meshtastic Web interface: [client.meshtastic.org](https://client.meshtastic.org).
2. Connect to your device.
3. Navigate to **Config** > **LoRa** menu.
3. Set **Region** according to your regional location.
4. Click the **Save** icon.
</TabItem>
</Tabs>
### Region Codes
<LoRaRegions />
Refer to [LoRa Region by Country](/docs/configuration/region-by-country) for a more comprehensive list.