🇩🇪 Deutsch | 🇬🇧 English | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano

_{by DJ0ABR (c) 2026}

Web dashboard for MeshCore nodes with a focus on desktop systems.

• runs on Linux (Raspberry Pi, PC, etc.)
• no smartphone required
• optimized for desktop monitors
• accessible with any modern browser on the local network

Among other things, the dashboard offers:

• display of nodes and rooms
• chat messages
• channel management
• repeater discovery
• map view of nodes

1. Open the WebFlasher on the MeshCore website.
2. Flash the Companion-USB package.

Clone the repository:

git clone https://github.com/USER/meshcore-webdashboard.git
cd meshcore-webdashboard

Install the packages:

sudo ./install.sh

Start MariaDB:

sudo mariadb

Insert the following SQL block:

DROP USER IF EXISTS 'meshcore'@'localhost';
CREATE DATABASE IF NOT EXISTS meshcore
CHARACTER SET utf8mb4
COLLATE utf8mb4_general_ci;
CREATE USER 'meshcore'@'localhost';
GRANT ALL PRIVILEGES ON meshcore.* TO 'meshcore'@'localhost';
FLUSH PRIVILEGES;

Compile everything:

make

Install the HTML files:

sudo cp -R html/* /var/www/html

Connect the hardware via USB.

Determine the serial port:

ls /dev/tty*

Examples:

If the port is ttyUSB0:

./meshcore_api

If the port is ttyACM0:

./meshcore_api /dev/ttyACM0

In a browser within the home network:

http://IP_of_the_Raspberry_Pi

1. Click the gear icon in the upper right corner.
2. In the setup window, enter the following data:

• Name (spaces and special characters are allowed)
• Longitude
• Latitude

3. Click Apply.

The dashboard is now ready to use.

When stations are received, they appear in the node list on the left side.

⚠️ Note:
It may take an hour or longer before the first nodes appear.

• Right-click on a node:
  A map with the node's position opens.

• Left-click on a chat or room:
  The chat window opens.

To search for MeshCore repeaters:

1. Click the magnifying glass icon in the upper right corner.
2. The Repeater Discovery window opens.
3. Click START.

Reachable repeaters will be searched for.
The process can be run multiple times.

In addition to the USB connection, the backend can also connect to a MeshCore Companion via TCP.

The Companion must be flashed with a special image: https://www.weyhmueller.org/webtools/esp32_ssid_patcher.html

1. Connect the Companion
2. Open the website
3. Select and flash firmware
4. Reboot the device

After a reset, the IP address is shown on the device display.
If there is no display, check your router (DHCP list).

./meshcore_api tcp://<IP>:5000

Example:

./meshcore_api tcp://192.168.10.170:5000

This project is licensed under the MIT License.

This project is not affiliated with the MeshCore project.