🚀 LightMon Desktop & PWA - Complete Server Monitoring Solution

Professional VM-based Server Monitoring Tool
Now available as Desktop App + Progressive Web App

🖥️ Desktop App • 📱 PWA Features • 🚀 Quick Start • 📖 Documentation

🎯 What's New - Complete Transformation!

Your Flask monitoring tool has been completely transformed into a modern, cross-platform solution:

✨ New Capabilities

🖥️ Native Desktop App (Windows, macOS, Linux)
📱 Progressive Web App (installable on mobile/desktop)
🔒 Enhanced Security (rate limiting, CSRF, headers)
📡 Offline Support (cached data, service worker)
🎨 Professional UI (modern design, responsive)
🔔 Native Notifications (desktop alerts)
📦 Easy Distribution (single executable files)

🖥️ Desktop Application

Electron-Powered Native App

Auto-start Flask backend when app launches
System tray integration (minimize to tray)
Native notifications for system alerts
Cross-platform - Works on Windows, macOS, Linux
Offline capability with cached dashboard data
Professional splash screen and branding

Key Desktop Features

✅ One-click startup (Flask + Electron together)
✅ Native window controls and menus
✅ System integration (notifications, tray)
✅ Auto-updater support built-in
✅ Secure communication between processes
✅ Professional installer packages

📱 Progressive Web App (PWA)

Mobile & Web Installation

Installable on Android, iOS, and desktop browsers
Offline functionality with service worker caching
App-like experience with native feel
Background sync when connection restored
Push notifications for real-time alerts
Responsive design for all screen sizes

PWA Features

✅ Add to home screen (mobile)
✅ Install from browser (desktop)
✅ Offline dashboard access
✅ Cached API responses
✅ Background data sync
✅ Native app shortcuts

🚀 Quick Start

Option 1: Interactive Startup (Recommended)

Windows:

# Double-click or run:
start-lightmon.bat

Linux/macOS:

chmod +x start-lightmon.sh
./start-lightmon.sh

Option 2: Direct Commands

Desktop App:

npm run electron-dev

Web App Only:

python backend/main.py

Build Executable:

pyinstaller lightmon.spec

📊 Core Monitoring Features

Real-time System Metrics

🖥️ CPU Usage - Per-core and overall utilization
💾 Memory Usage - RAM allocation and availability
💿 Disk Usage - Storage space and I/O operations
🌐 Network Activity - Bandwidth and packet statistics
⚡ Process Monitoring - Top resource-consuming processes

Advanced Features

🚨 Smart Alerts - Customizable thresholds
🖥️ Multi-Host Support - Monitor multiple servers
👥 User Management - Role-based access control
📈 Historical Data - Trend analysis and reporting
🔄 Real-time Updates - WebSocket-powered live data

🛠️ Installation & Setup

Prerequisites

Python 3.8+
Node.js 16+
Git (optional)

Step 1: Get the Code

git clone <your-repo-url>
cd lightmon

Step 2: Install Dependencies

# Python dependencies
C

Step 3: Launch

# Interactive launcher
./start-lightmon.sh    # Linux/Mac
start-lightmon.bat     # Windows

# Or directly
npm run electron-dev   # Desktop app
python backend/main.py # Web app

📦 Distribution & Packaging

Desktop Executables

Windows (.exe):

build-scripts\build-windows.bat
# Output: dist\LightMon.exe

macOS (.app):

./build-scripts/build-mac.sh
# Output: dist/LightMon.app

Linux (AppImage):

./build-scripts/build-linux.sh  
# Output: dist/LightMon

Electron Distributables

npm run build-win    # Windows installer
npm run build-mac    # macOS DMG
npm run build-linux  # Linux packages

🔒 Security & Production Features

Enhanced Security

🛡️ Rate Limiting - Prevent API abuse
🔐 CSRF Protection - Secure form submissions
🚫 Security Headers - XSS, clickjacking protection
🍪 Secure Sessions - HTTPOnly, SameSite cookies
🔑 Strong Secrets - Cryptographically secure keys

Production Ready

📊 Health Check Endpoint - /api/health
🐳 Docker Support - Container deployment
📝 Comprehensive Logging - Error tracking
🔄 Auto-restart - Process management
📈 Performance Optimized - Efficient monitoring

🎨 User Interface

Modern Design

🎨 Professional Theme - Clean, modern interface
🌓 Dark/Light Mode - User preference toggle
📱 Responsive Layout - Works on all devices
📊 Interactive Charts - Real-time data visualization
🎯 Intuitive Navigation - Easy-to-use interface

Desktop-Specific UI

🖥️ Native Menus - Platform-appropriate controls
🔔 System Notifications - Native alert popups
📌 System Tray - Background operation
⌨️ Keyboard Shortcuts - Power user features

📖 Documentation

Complete Guides

📋 SETUP.md - Detailed setup instructions
📁 PROJECT_STRUCTURE.md - Code organization
🔧 Build Scripts - Automated packaging
🐳 Docker Compose - Container deployment

API Documentation

GET  /api/health           - Health check
GET  /api/metrics/detailed - System metrics
GET  /api/hosts           - Host management
GET  /api/alerts          - Alert history
POST /api/threshold/<metric> - Configure thresholds

🎯 Use Cases

Perfect For:

🏢 System Administrators - Monitor server infrastructure
💻 Developers - Track application performance
🏠 Home Labs - Monitor personal servers
🏭 Small Businesses - Cost-effective monitoring
🎓 Students - Learn system monitoring concepts

Deployment Scenarios:

🖥️ Desktop Monitoring - Local system oversight
🌐 Web Dashboard - Browser-based access
📱 Mobile Monitoring - On-the-go system checks
🐳 Container Deployment - Docker/Kubernetes
☁️ Cloud Hosting - AWS, Azure, DigitalOcean

🔧 Customization

Easy Modifications

🎨 Branding - Update logos, colors, app name
📊 Metrics - Add custom monitoring points
🚨 Alerts - Configure notification methods
🎯 Thresholds - Set custom warning levels
🔌 Integrations - Connect to external services

Configuration Files

frontend/manifest.json - PWA settings
package.json - Electron configuration
lightmon.spec - PyInstaller build settings
backend/.env - Environment variables

🚀 What You Get

🎁 Complete Package:

✅ Cross-platform desktop application
✅ Mobile-installable PWA
✅ Real-time monitoring dashboard
✅ Professional UI/UX design
✅ Offline functionality
✅ Native notifications
✅ Easy deployment options
✅ Production-ready security
✅ Comprehensive documentation
✅ Build automation scripts

🤝 Contributing

We welcome contributions! Here's how to get started:

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

Development Setup

# Clone your fork
git clone <your-fork-url>
cd lightmon

# Install dependencies
pip install -r requirements.txt
npm install

# Start development
npm run electron-dev

📞 Support

Getting Help

📖 Check the SETUP.md guide
🔍 Review troubleshooting section
🐛 Open an issue for bugs
💡 Request features via issues

Common Issues

Desktop app won't start → Check Python/Node.js installation
PWA won't install → Ensure HTTPS in production
Build failures → Clear cache and reinstall dependencies

📄 License

MIT License - feel free to use in personal and commercial projects!

🎉 Congratulations!

You now have a complete, professional server monitoring solution that works everywhere:

✅ Desktop apps for Windows, macOS, and Linux
✅ Mobile PWA for Android and iOS
✅ Web dashboard for any browser
✅ Offline capability with cached data
✅ Professional UI with modern design
✅ Production-ready security and features

Happy Monitoring! 🚀📊🖥️📱

Made with ❤️ for system administrators and developers worldwide

⭐ Star this repo • 🐛 Report issues • 🔄 Fork & contribute

# LightMon

Name		Name	Last commit message	Last commit date
.vscode		.vscode
backend		backend
build-scripts		build-scripts
electron		electron
frontend		frontend
instance		instance
node_modules		node_modules
pythonProject3/.idea		pythonProject3/.idea
venv		venv
PROJECT_STRUCTURE.md		PROJECT_STRUCTURE.md
README.md		README.md
SETUP.md		SETUP.md
app.py		app.py
docker-compose.yml		docker-compose.yml
lightmon.spec		lightmon.spec
main.py		main.py
package-lock.json		package-lock.json
package.json		package.json
requirements.txt		requirements.txt
run.bat		run.bat
run_fixed.bat		run_fixed.bat
start-lightmon.bat		start-lightmon.bat
start-lightmon.sh		start-lightmon.sh

Latest commit

History

Folders and files

Repository files navigation