Self-hosted Meshtastic monitoring for multi-source networks — real-time maps, alerts, per-source permissions, and full network awareness.
Need a Custom Configuration?
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:
cat > docker-compose.yml << 'EOF'
services:
meshmonitor:
image: ghcr.io/yeraze/meshmonitor:latest
container_name: meshmonitor
ports:
- "8080:3001"
volumes:
- meshmonitor-data:/data
environment:
- MESHTASTIC_NODE_IP=192.168.1.100 # Seeds the first source on first boot; add more from Dashboard → Sources
- ALLOWED_ORIGINS=http://localhost:8080 # Required for CORS
restart: unless-stopped
volumes:
meshmonitor-data:
EOF
docker compose up -dAccess at http://localhost:8080 and login with username admin and password changeme.
That's it! No SESSION_SECRET or complex configuration needed for basic usage. MeshMonitor works over HTTP out of the box.
For production deployments, Kubernetes, reverse proxies, and advanced configurations, see the Production Deployment Guide.
Meshtastic is an open-source, off-grid, decentralized mesh network built on affordable, low-power devices. MeshMonitor provides a web-based interface to monitor and manage your Meshtastic network.
View your entire mesh network on an interactive map, with nodes colored by their signal strength and connectivity status. Track node positions, signal quality, and network topology in real-time.
Access complete message history across all channels. Search, filter, and export messages for analysis or record-keeping.
Monitor individual node health, battery levels, environmental telemetry, and connection status. View detailed statistics for each node in your network.
Manage multiple channels, view channel settings, and monitor message flow across different communication channels in your mesh.
Automatically detect and flag nodes with security vulnerabilities. MeshMonitor identifies low-entropy (weak) encryption keys and duplicate keys shared across multiple nodes. Visual warnings and filtering options help you maintain a secure mesh network.
MeshMonitor supports multiple deployment scenarios:
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 (with Serial/BLE via the bridge sidecars), USB-attached MeshCore, and the embedded MQTT broker are first-class today; TCP MeshCore is supported via the legacy env-var bootstrap path.
Add, edit, restart, or delete any upstream connection from the dashboard. No env-var edits, no container restarts.
Each TCP source gets its own Virtual Node endpoint, its own auto-responder, its own scheduler — all in one Edit Source dialog.
Grant a user admin rights on one source, read-only on another, and hide a third. Per-channel controls sit right alongside the source scope dropdown.
Theme, language, map defaults, push keys, backup schedule — the things that apply to the whole deployment — live on one screen.
Read and search messages across every source from a single view, with an optional per-source filter.
Telemetry charts, gauges, and tables aggregated across every connected source.
Track your entire mesh network at a glance with the interactive map and real-time node positions.
Collapsible sidebar and responsive layout for iOS and Android PWAs.
Ready to get started? Head over to the Getting Started guide!