Self-hosted multi-protocol mesh monitoring for Meshtastic, MeshCore, and MQTT β real-time maps, alerts, per-source permissions, and full network awareness.
Connect Meshtastic (TCP, or USB and Bluetooth through a bridge), MeshCore, and MQTT brokers all at once, plus Reticulum through a bridge. Per-source maps, messages, telemetry, and traceroutes. Add or remove a source without a restart.
π‘
MeshCore Support
First-class MeshCore companions and repeaters living alongside your Meshtastic nodes. Per-source permissions, a multi-pane page with channels, DMs, and telemetry, and contacts plotted on the unified map.
π
Embedded MQTT Broker & Bridge
Host an MQTT broker inside MeshMonitor, run standalone client bridges to upstreams, or combine the two. Filter what crosses the boundary by topic, channel, portnum, or geographic bounding box β your local mesh stays clean without firmware changes.
π
Per-Source Permissions
Grant users access to specific sources, not the whole deployment. Local accounts, SSO (OIDC), MFA, and a full admin audit log.
π
Per-Source Virtual Node
Each source exposes its own Virtual Node endpoint. Run multiple Meshtastic mobile apps through MeshMonitor with message queuing and config caching, or connect the MeshCore app to a managed MeshCore device over WiFi.
πΊοΈ
Interactive Map
Real-time node positions colored by hop count, link quality, and topology overlays. 3D terrain and link profiles for planning. GeoJSON / KML / KMZ imports for zones, plus an optional polar grid for RF coverage.
π
Analytics & Telemetry
Charts, gauges, and numeric widgets across every source. Unified telemetry views with search, sort, and per-source filtering.
Built-in auto-responders, scheduled messages, auto-traceroute, and geofences, plus the visual Automation Engine for your own when-this-do-that rules. Extend with Python, JavaScript, or shell scripts. Automated sends are flagged so bots don't reply to each other.
π¬
Store & Forward
Flag S&F servers on the map and record the history they replay, tagged so you can tell it from live traffic.
Coverage reports, a traceroute explorer, mesh issue checks, and a packet monitor show where your mesh is weak and why.
π
Public-Instance Mode
Open your dashboard to the public with less exposure. Signed-out viewers see positions snapped to about 1.5 km, and long names, keys, and message text hidden.
π
Security Monitoring
Automatic detection of weak or duplicate encryption keys across your nodes. Full admin audit log of every privileged action.
π
Push Notifications
Push alerts on Android, desktop, and iOS (as an installed web app), even when the tab is closed. Needs HTTPS except on localhost. Apprise for email, Slack, Discord, Telegram, and more.
π₯οΈ
Remote Administration
Configure devices and manage channels from the web UI, no SSH or CLI. Admins can push OTA firmware to ESP32 Meshtastic nodes after a one-time bootloader flash.
Bring your own vector or raster tiles (TileServer GL, nginx, XYZ). Upload custom MapLibre styles for branded or offline-first maps.
π¨
Customizable Themes
15 built-in themes plus a visual editor. Color-blind friendly and WCAG AAA high-contrast variants. Import / export to share.
βοΈ
Solar Monitoring
forecast.solar projections alongside telemetry. Auto-detect solar nodes and surface ones predicted at risk for off-grid deployments.
π»
Desktop & Mobile
Native desktop app for Windows and macOS. Installable web app for iOS and Android.
π³
Flexible Deployment
Docker Compose, Kubernetes (Helm), Proxmox LXC, or bare metal. SQLite, PostgreSQL, or MySQL. Reverse-proxy-friendly with built-in update notifications.
Use our Interactive Configurator to generate a customized docker-compose.yml for your specific setup (TCP, BLE, Serial, reverse proxy, etc.).
Get MeshMonitor running in under 60 seconds with Docker Compose:
bash
cat > docker-compose.yml << 'EOF'services: meshmonitor: image: ghcr.io/yeraze/meshmonitor:latest container_name: meshmonitor ports: - "8080:3001" volumes: - meshmonitor-data:/data environment: - ALLOWED_ORIGINS=http://localhost:8080 # The URL you open in your browser, e.g. http://192.168.1.50:8080 restart: unless-stoppedvolumes: meshmonitor-data:EOFdocker compose up -d
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
Open http://localhost:8080, log in as admin / changeme, then add your radio with the + next to Sources in the dashboard sidebar. If you browse from another machine, set ALLOWED_ORIGINS to that URL first, or you may get a blank screen.
No SESSION_SECRET or other setup is needed for basic use. MeshMonitor works over HTTP out of the box.
For production deployments, Kubernetes, reverse proxies, and advanced configurations, see the Production Deployment Guide.
MeshMonitor speaks several off-grid mesh ecosystems and treats them as peers in one deployment:
Meshtastic β an open-source, off-grid, decentralized mesh network built on affordable, low-power devices. Connect over TCP, Serial (via the Serial Bridge), or BLE (via the BLE Bridge).
MeshCore β companions and repeaters connected over USB or TCP, alongside or instead of Meshtastic.
MQTT β connect to an external MQTT broker as a source (receive, and send without a local radio), or run the embedded broker with two-way bridges to public upstreams.
Pick one or mix them β MeshMonitor's unified views, per-source permissions, and the same automation, telemetry, and map features apply to every source you add.
View every connected mesh β Meshtastic, MeshCore, MQTT β on a single interactive map, with nodes colored by hop count, source, or gateway. Track node positions, signal quality, and network topology in real-time.
Monitor individual node health, battery levels, environmental telemetry, and connection status. View detailed statistics for each node in your network, regardless of source protocol.
Manage multiple channels, view channel settings, and monitor message flow across different communication channels β Meshtastic channels, MeshCore channels, and MQTT topics alike.
Automatically detect and flag nodes with security vulnerabilities. MeshMonitor identifies low-entropy (weak) encryption keys and duplicate keys shared across multiple Meshtastic nodes. Visual warnings and filtering options help you maintain a secure mesh.
Every source your deployment touches shows up in the sidebar with its own health, map pin colour, and unified or source-scoped views. Meshtastic (TCP, plus Serial/BLE via the bridge sidecars), MeshCore (USB or TCP), MQTT brokers, and the embedded MQTT bridge are all first-class β mix and match without a restart.
A cross-source Telemetry Dashboard: every favorited telemetry graph from every source you can read, with one merged line for readings the node takes itself (battery, temperature) and one line per source for readings that depend on who heard it (SNR, RSSI). A Latest tab shows the newest reading of each node per source, and a star there adds the reading to that source's favorites.