back to home

Yeraze / meshmonitor

Web tool for monitoring a Meshtastic Node Deployment over TCP/HTTP

359 stars
42 forks
3 issues
TypeScriptCSSShell

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing Yeraze/meshmonitor in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/Yeraze/meshmonitor)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

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**: **Default login:** / (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 This starts both the React dev server (port 5173) and the Express API server (port 3001). Available Scripts **Development:** • - Start React development server • - Start Express API server • - Start both development servers • - Build React app for production • - Build Express server for production **Testing & Quality:** • - Run tests in watch mode • - Run all tests once • - Generate coverage report • - Run ESLint • - 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: • Fork the repository • Create a feature branch ( ) • Make your changes and add tests • Run tests locally ( ) • Commit with conventional commits ( ) • 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._