Meshcord is a lightweight MQTT-to-Discord alert system designed specifically for Meshtastic. It listens for incoming messages on specified Meshtastic channels (via MQTT) and sends formatted notifications to a Discord channel using a webhook. Ideal for users who want real-time mesh alerts delivered to their phone or desktop via Discord — no need to carry your node 24/7!
- 🛰️ Monitors multiple Meshtastic channels
- 📡 Sends alerts to a Discord channel via webhook
- 🔒 Runs locally on your network (no cloud dependencies)
- 🧠 Requires no Discord bot setup — just a webhook
- 🐳 Official Docker image available
- 🧩 Supports Unraid with custom icon
👉 Official Docker Image:
mmagtech/meshcord on Docker Hub
docker run -d \
--name meshcord \
-e DISCORD_WEBHOOK_URL="your_webhook_url" \
-e MQTT_BROKER="192.168.1.10" \
-e MQTT_PORT="1883" \
-e CHANNELS="1:Chat,2:Alerts" \
-e TIMEZONE="America/New_York" \
mmagtech/meshcordUse the following as the container icon:
📎 https://imgur.com/6WAbb44.png
| Variable | Description | Required |
|---|---|---|
DISCORD_WEBHOOK_URL |
Webhook URL from your Discord server | ✅ |
MQTT_BROKER |
IP address of your MQTT broker | ✅ |
MQTT_PORT |
MQTT broker port (default: 1883) | ✅ |
CHANNELS |
Comma-separated list of channel_number:name |
✅ |
TIMEZONE |
Timezone (e.g., America/New_York) |
✅ |
To monitor your mesh network from home:
- Connect your Meshtastic node to Wi-Fi.
- Go to the Meshtastic Web UI:
- Enable MQTT
- Set
MQTT Server Addressto your broker IP (e.g.,192.168.1.10) - Set
Root topictomeshtastic(or keep default)
- On the desired channels:
- Enable Uplink (✅ Required)
- Leave Downlink disabled (✅ Not required)
- MQTT channel name does not need to be
mqtt
You’re away from home without your Meshtastic node.
Someone sends a message to your shared channel via LoRa.
Your home node receives it and Meshcord sends a formatted alert to Discord.
Boom — you’re in the loop in real time.
docker build -t meshcord .