Configuration v1.5+

This guide walks you through the process of setting up and configuring your MeshCore devices for optimal performance.

🔧 Basic Setup

Essential commands and configurations for all devices

📡 Network Config

Optimizing your mesh network topology

🔒 Security

Password management and access control

🗺️ Maps & Location

Setting up navigation features

---

Configuring Repeaters and Room Servers

After flashing the latest firmware onto your device, keep the device connected to your computer via USB serial, use the console feature on the web flasher and set the frequency for your region or country:

set freq {frequency}

IMPORTANT

This step is essential so your client can remote administer the repeater or room server over RF.

For a complete list of available commands, check the repeater and room server CLI reference.

Configuring Repeater Mode on a Room Server

A room server can also take on the repeater role. To enable the repeater role on a room server, use this command:

set repeat {on|off}

This configuration allows your room server to relay messages while retaining its message storage and distribution functionalities.

Repeater Location

Best Practice: Place the repeater high above ground to extend your MeshCore network's reach.

Remote Administration

Repeaters and room servers can be administered remotely in two ways:

T-Deck Method

Using a T-Deck running MeshCore firmware with remote administration features unlocked

Smartphone Method

From a BLE Companion client connected to a smartphone running the MeshCore app

This remote administration is done via RF (radio frequency), allowing you to manage your devices without a physical connection.

Administration Passwords

Repeater and Room Server Admin Password

The default admin password to a repeater and room server is password. Use the following command to change the admin password:

password {new-password}

Room Server Guest Password

The default guest password to a room server is hello. Use the following command to change the guest password:

set guest.password {guest-password}

SECURITY NOTE

Always change default passwords to improve the security of your MeshCore network.

Connecting to Room Servers

When a client logs into a room server, the client will receive the previously 16 unseen messages. This feature allows roaming users to come back later and retrieve message history, similar to an email server.

Setting Up Maps on T-Deck

1

Prepare SD Card

Format an SD card to FAT32 (maximum size 32 GB)

2

Create Directory

Create a tiles folder at the root of the SD card

3

Add Map Tiles

Add map tiles to this folder using one of the methods below

Map Tile Options

Source	Description	Link
Europe Maps	Pre-packaged tiles for European regions	BuyMeACoffee
US Maps	Pre-packaged tiles for United States	BuyMeACoffee
UK Maps	Custom UK region map tiles	Discord Channel
Custom	Generate your own map tiles	MTD Python Script
Enhanced Custom	Improved version with parallel downloads	Discord Link

Once you have the tiles downloaded, place the tiles folder in the root directory of the SD card.

Unlocking Advanced Features

The MeshCore firmware on T-Deck is free to use. Some features are unlocked via a one-time purchase:

🔑

Premium Features

Unlock codes can be purchased from BuyMeACoffee

• Higher map zoom levels
• Server management functions