MeshCore Server Administration
Configure and manage your MeshCore repeaters and room servers
What is Server Administration?
Besides companion firmware for daily use, MeshCore also offers repeater and room server firmware. These devices run autonomously and require some configuration before they function optimally.
This guide explains how to configure these servers via the web interface, the MeshCore app, or command-line tools. You'll learn about password management, setting location and remote administration.
Server Types
Repeater
Forwards messages to other nodes. Essential for extending network range. Repeaters work completely autonomously and periodically broadcast their presence.
Room Server
A kind of bulletin board or chatroom. Users can post and read messages. The server stores message history and pushes updates to connected users.
Tip: Run repeaters and room servers on separate devices when possible. This prevents conflicts and makes management easier.
Configuration Methods
There are multiple ways to configure your MeshCore server:
Web Interface (config.meshcore.dev)
Connect your device via USB and open config.meshcore.dev in Chrome or Edge. You'll get a graphical interface for all settings.
Web Flasher Console
After flashing via the web flasher, you can directly enter commands in the console. Handy for quick configuration without extra tools.
Smartphone App
The MeshCore app for Android and iOS offers remote administration for repeaters and room servers. Connect via Bluetooth or the mesh network.
T-Deck Remote Admin
Registered T-Deck devices can configure other servers in the network via the mesh network itself.
Managing Passwords
Admin Password
The admin password protects the configuration of your repeater or room server. Only with this password can you change settings.
Default password: password
Change via console: password {new-password}
⚠️ Change the default password as soon as possible! Anyone who knows the default password can configure your server.
Guest Password (Room Server)
Room servers have a separate guest password that allows users to join the chatroom.
Default guest password: hello
Change via console: set guest.password {guest-password}
Setting Location
By setting the location of your repeater, it will appear on the MeshCore map. This helps others understand the network.
Set latitude:
set lat {GPS Latitude}
Set longitude:
set long {GPS Longitude}
Example for Amsterdam:
set lat 52.3676set long 4.9041
You can look up GPS coordinates via Google Maps. Right-click on the location and copy the coordinates.
Private Key Management
Every MeshCore node has a unique private key for encryption. You can retrieve or set this via the console.
Get private key:
get prv.key
Set private key:
set prv.key {hex-value}
⚠️ After changing the private key, you must restart the device. The key is essential for encryption - keep it safe!
Common Commands
Get device info
info
Set frequency
set freq 868.0
Choose preset (EU/UK)
set preset eu
Set device name
set name {name}
Restart device
reboot
Factory reset
factory-reset
Best Practices
- ✓ Always change the default admin password before deploying the device
- ✓ Set the location so your repeater appears on the map
- ✓ Use 868 MHz preset for the Netherlands and Europe
- ✓ Run repeaters and room servers on separate devices
- ✓ Update firmware regularly for bugfixes and new features
- ✓ Make a backup of your private key
Frequently Asked Questions
Can I remotely adjust the configuration?
Yes, via the MeshCore app or a registered T-Deck you can remotely configure repeaters and room servers. You do need the admin password.
What happens during a factory reset?
All settings are erased, including passwords, location and private key. The device generates a new private key at startup.
How often do repeaters broadcast their presence?
Repeaters automatically send an "advert" every 12 hours with their name, location and public key. This cannot be adjusted.
Ready to configure your server?
Start with the web interface for the easiest configuration experience