MeshMonitor

Appearance

GitHub Stars

MeshMonitorMonitor Your Meshtastic Network

A powerful web application for monitoring Meshtastic nodes over IP with real-time updates, interactive maps, and comprehensive network analytics.

Get Started
View on GitHub
Interactive Map
Interactive Map
Channel Messaging
Channel Messaging
Security Scanner
Security Scanner
🗺️

Interactive Map View

Visualize your mesh network on an interactive map with real-time node positions, signal strength indicators, and network topology.

📊

Comprehensive Analytics

Track message statistics, node health, signal quality (SNR), and network performance over time with detailed charts and graphs.

🔄

Real-time Updates

Monitor your network in real-time with automatic updates. See new messages, node status changes, and network events as they happen.

💬

Message Management

View, send, and manage messages across your mesh network. Support for multiple channels and message history.

🔐

Security Monitoring

Automatic detection of weak encryption keys and duplicate key issues. Built-in authentication with local accounts and SSO support for enterprise deployments.

🐳

Easy Deployment

Deploy with Docker Compose or Kubernetes (Helm charts included). Simple configuration for both development and production environments.

🌐

Virtual Node Server

Connect multiple Meshtastic mobile apps simultaneously through MeshMonitor's Virtual Node proxy. Message queuing, config caching, and connection stability for 3-5+ concurrent mobile clients.

📱

Responsive Design

Works seamlessly on desktop, tablet, and mobile devices. Monitor your network from anywhere.

🗺️

Custom Map Tile Servers

Configure custom map tile servers with support for both vector (.pbf) and raster (.png) tiles. Enable offline operation, custom styling, and privacy-focused mapping. Works with TileServer GL, nginx caching proxy, and standard XYZ tile servers for complete independence from external services.

🎨

Customizable Themes

Choose from 15 built-in themes or create your own with the visual theme editor. Includes color-blind friendly options, WCAG AAA compliant high-contrast themes, and full import/export support for sharing custom themes.

🔔

Push Notifications

Receive real-time alerts for new messages on iOS, Android, and desktop - even when the app is closed. Zero configuration, works with HTTPS.

🔧

Flexible Configuration

Configure reverse proxies, HTTPS, environment variables, and more. Adapt MeshMonitor to your infrastructure needs.

☀️

Solar Monitoring

Integrate with forecast.solar to visualize expected solar production alongside telemetry data. Perfect for optimizing off-grid deployments and predicting power availability.

⚡

Automation & Triggers

Create powerful automations with Auto-Responders, Scheduled Messages, Auto-Traceroute, and Geofence Triggers. Respond to keywords, schedule broadcasts, and trigger actions based on node locations.

📍

Geofence Triggers

Define geographic zones on an interactive map and trigger automated responses when nodes enter, exit, or remain inside. Perfect for arrival notifications, asset tracking, and proximity alerts.

📜

Custom Scripting

Extend MeshMonitor with custom Python or Bash scripts. Execute scripts on message events, geofence triggers, or scheduled intervals. Full access to message context and node information.

🔧

Remote Administration

Change node connections on-the-fly without container restarts. Configure device settings, manage channels, and send admin commands directly from the web interface.

Quick Start ​

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:

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:
      - MESHTASTIC_NODE_IP=192.168.1.100  # Change to your node's IP
    restart: unless-stopped

volumes:
  meshmonitor-data:
EOF

docker compose up -d

Access 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.

What is Meshtastic? ​

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.

Key Features ​

Network Visualization ​

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.

Message History ​

Access complete message history across all channels. Search, filter, and export messages for analysis or record-keeping.

Node Management ​

Monitor individual node health, battery levels, environmental telemetry, and connection status. View detailed statistics for each node in your network.

Channel Configuration ​

Manage multiple channels, view channel settings, and monitor message flow across different communication channels in your mesh.

Security Monitoring ​

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.

Deployment Options ​

MeshMonitor supports multiple deployment scenarios:

  • Docker Compose: Quick local deployment for testing and development
  • Kubernetes: Production-ready deployment with Helm charts
  • Bare Metal: Direct installation with Node.js for custom environments

Screenshots ​

Interactive Map ​

Track your entire mesh network at a glance with the interactive map and real-time node positions.

Interactive Map

Channel Messaging ​

Communicate across your mesh network with multi-channel messaging and real-time updates.

Channel Messaging

Telemetry Dashboard ​

Monitor node telemetry with customizable widgets, charts, and historical data analysis.

Telemetry Dashboard

Device Configuration ​

Configure your Meshtastic device settings, channels, and radio parameters directly from the web UI.

Device Configuration

Community & Support ​

Ready to get started? Head over to the Getting Started guide!