MeshMonitor

A comprehensive web application for monitoring Meshtastic mesh networks over IP. Built with React, TypeScript, and Node.js, featuring a beautiful Catppuccin Mocha dark theme and multi-database support (SQLite, PostgreSQL, MySQL).

Documentation

For complete documentation, visit meshmonitor.org

• Getting Started Guide - Installation and quick start
• FAQ - Frequently asked questions and troubleshooting
• Configuration - Detailed configuration options
• Development - Contributing and development setup

Quick Start

Get MeshMonitor running in 60 seconds:

# 1. Create docker-compose.yml
cat > docker-compose.yml << 'EOF'
services:
  meshmonitor:
    image: ghcr.io/yeraze/meshmonitor:latest
    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

# 2. Start MeshMonitor
docker compose up -d

# 3. Open http://localhost:8080

Default login: admin / changeme (change after first login!)

For detailed installation instructions, configuration options, and deployment scenarios, see the Getting Started Guide.

Deployment Options

MeshMonitor supports multiple deployment methods:

• 🐳 Docker (Recommended) - Pre-built multi-architecture images with auto-upgrade support

  • Docker Compose Guide
  • Platforms: amd64, arm64, armv7

• ☸️ Kubernetes - Helm charts for production clusters

  • Helm Chart
  • GitOps-ready with ArgoCD/Flux support

• 📦 Proxmox LXC - Lightweight containers for Proxmox VE

  • Proxmox LXC Guide
  • Pre-built templates available
  • Community-supported alternative

• 🔧 Manual - Direct Node.js deployment

  • Manual Installation Guide
  • For development or custom setups

• 🖥️ Desktop Apps - Native applications for Windows and macOS

  • Download from GitHub Releases
  • Runs as a system tray application
  • Windows (.exe) and macOS (.dmg) installers available

Key Features

• Real-time Mesh Monitoring - Live node discovery, telemetry, and message tracking
• Modern UI - Catppuccin theme with message reactions and threading
• Interactive Maps - Node positions and network topology visualization
• Multi-Database Support - SQLite (default), PostgreSQL, and MySQL via Drizzle ORM
• Notifications - Web Push and Apprise integration for 100+ services
• Authentication - Local and OIDC/SSO support with RBAC
• Security Monitoring - Encryption key analysis and vulnerability detection
• Device Configuration - Full node configuration UI
• Virtual Node Server - Remote TCP access for Meshtastic Python clients
• REST API - v1 API with Bearer token authentication for external integrations
• MeshCore Support - Optional monitoring for MeshCore mesh networks
• Docker Ready - Pre-built multi-architecture images
• One-click Self-Upgrade - Automatic upgrades from the UI with backup and rollback
• System Backup & Restore - Complete disaster recovery with automated backups

For a complete feature list and technical details, visit meshmonitor.org.

Development

Prerequisites

• Node.js 20+
• Docker (recommended) or local Node.js environment
• A Meshtastic device with WiFi/Ethernet connectivity

Local Development

# Clone with submodules
git clone --recurse-submodules https://github.com/Yeraze/meshmonitor.git
cd meshmonitor

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your Meshtastic node's IP address

# Start development servers
npm run dev:full

This starts both the React dev server (port 5173) and the Express API server (port 3001).

Available Scripts

Development:

• npm run dev - Start React development server
• npm run dev:server - Start Express API server
• npm run dev:full - Start both development servers
• npm run build - Build React app for production
• npm run build:server - Build Express server for production

Testing & Quality:

• npm run test - Run tests in watch mode
• npm run test:run - Run all tests once
• npm run test:coverage - Generate coverage report
• npm run lint - Run ESLint
• npm run typecheck - Run TypeScript compiler checks

Technology Stack

Frontend:

• React 19 with TypeScript
• Vite 7 (build tool)
• CSS3 with Catppuccin theme
• Translation support crowdsourced by Weblate

Backend:

• Node.js with Express 5
• TypeScript
• Drizzle ORM with SQLite, PostgreSQL, and MySQL drivers

DevOps:

• Docker with multi-stage builds
• Docker Compose for orchestration
• GitHub Container Registry for images

Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Development setup
• Testing requirements
• Code style guidelines
• Pull request process
• CI/CD workflows

Quick start:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and add tests
4. Run tests locally (npm run test:run)
5. Commit with conventional commits (feat: add amazing feature)
6. Push and create a Pull Request

License

This project is licensed under the BSD-3-Clause License - see the LICENSE file for details.

Community & Support

• Discord: Join our Discord - Chat with the community and get help
• GitHub Issues: Report bugs and request features
• Documentation: meshmonitor.org

Acknowledgments

• Meshtastic - Open source mesh networking
• Catppuccin - Soothing pastel theme
• React - Frontend framework
• Drizzle ORM - TypeScript ORM
• better-sqlite3 - SQLite driver

Star History

---

MeshMonitor - Monitor your mesh, beautifully. 🌐✨

This application is brought to you with help from Claude Code.