ProxMenux v1.2.0

Final release of the v1.2.0 cycle. This version consolidates the work from the v1.1.9.1 → v1.1.9.6 beta series and introduces the biggest evolution of ProxMenux Monitor to date: AI-enhanced notifications, a redesigned multi-channel notification system, a reworked hardware and storage experience, and broad performance improvements across the monitoring stack. It also consolidates all recent work on the Storage, Hardware and GPU/TPU scripts.

Main changes in v1.2.0

AI-Enhanced Notifications

Notifications can now be enhanced using AI to generate clear, contextual messages instead of raw technical output. Instead of backup completed exitcode=0 size=2.3GB, AI produces: "The web server backup completed successfully. Size: 2.3GB".

• Multi-Provider Support: Groq, Google Gemini, OpenAI, Anthropic Claude, OpenRouter and Ollama (local)
• Per-Provider API Keys: switch providers without re-entering credentials
• Verified AI Models: curated list (verified_ai_models.json) tested for notification enhancement; daily verification auto-migrates to a verified alternative if the current model becomes unavailable
• Per-Provider Model Memory: your selected model is preserved per provider
• Customizable Detail Level: minimal, standard or detailed per channel
• Multi-Language Support: messages generated in your preferred language
• Custom AI Prompts: full control over format and translation, with export/import and an example template
• Enriched Context: selective uptime, event frequency, SMART data, and known Proxmox errors passed to the AI for better diagnosis

AI only translates technical notifications into readable messages — it is not a chatbot, does not analyze your system, does not execute commands, and does not store history.

Notification System Redesign

• Multi-Channel Architecture: Telegram, Discord, Pushover, Email and Webhook simultaneously
• Per-Event Configuration: enable/disable specific event types per channel
• Channel Overrides: customize notification behaviour per channel
• Secure Webhook Endpoint: authenticated endpoint for external systems
• Encrypted Storage: API keys and sensitive data stored encrypted
• Queue-Based Processing: background worker with automatic retry
• Telegram Topics Support: send notifications to a specific topic inside Topic-enabled groups
• Dashboard Update Indicator: the ProxMenux logo changes to an update variant when a new version is detected (stable and beta channels)
• ProxMenux Update Notifications: automatic detection of new versions via version.txt and beta_version.txt

Hardware Panel — Expanded Detection

• SCSI / SAS / RAID Controllers: model, driver and PCI slot shown in the storage controllers section
• PCIe Link Speed Detection: NVMe drives show current link speed (PCIe generation and lane width), making it easy to spot drives underperforming due to limited slot bandwidth
• Enhanced Disk Detail Modal: NVMe, SATA, SAS and USB drives expose their specific fields (PCIe link info, SAS version/speed, interface type)
• Smarter Disk Type Recognition: uniform labelling for NVMe SSDs, SATA SSDs, HDDs and removable disks
• Hardware Info Caching (lspci, lspci -vmm): 5 min cache avoids repeated scans for data that doesn't change

Storage Overview — Health, Observations, Exclusions

Disk Health Status Alignment

• Badges now reflect the current SMART state, not a historical worst value
• Historical findings remain accessible via the "X obs." badge
• Automatic recovery when SMART reports healthy again
• Removed the old worst_health tracking that required manual clearing

Disk Registry Improvements

• Smart serial lookup prevents duplicate entries when a disk appears with/without a serial
• Better handling of USB drives that may appear under different device names

Storage and Network Interface Exclusions

• Storage Exclusions: exclude drives from health monitoring and notifications
• Network Interface Exclusions: new section for excluding bridges (vmbr), bonds, physical NICs and VLANs from health/notifications
• Separate toggles for Health monitoring and Notifications

Disk Detection Robustness

• Power-On-Hours validation detects and corrects absurdly large values from drives with non-standard SMART encoding
• Intelligent bit masking extracts correct data from drives that encode extra info in high bytes
• Graceful "N/A" fallback when data cannot be parsed

Health Monitor & Error Lifecycle

Stale Error Cleanup

• Errors for deleted VMs/CTs and removed disks are automatically resolved
• Cluster errors clear when a node leaves the cluster
• Log-based errors auto-resolve after 48 hours without recurrence
• Security update notifications auto-resolve after 7 days

Database Migration System

• Automatic detection and addition of missing columns on startup
• Schema compatibility with old and new column naming
• Backwards compatible with older ProxMenux databases
• No data loss during schema updates

VM / CT Detail Modal and Mobile UX

• Tabbed Navigation: Overview and Backups tabs
• Visual Enhancements: icons, improved hierarchy, better VM vs CT distinction
• Mobile Responsiveness: correctly adapts to small screens in both webapp and direct browser access
• Secure Gateway Modal: scrollable storage list and mobile-adapted layout
• Terminal Connection: reconnection loop fix affecting mobile devices, improved WebSocket handling and more graceful timeout recovery
• Fail2ban & Lynis Management: delete buttons added in Settings with confirmation dialog

Performance Optimizations

Staggered Polling Intervals

Cached System Information

Increased journalctl Timeouts

Reduced Polling Frequency

• TaskWatcher interval raised from 2s → 5s (60% fewer checks)

GitHub Actions

• All workflow actions upgraded to v6 for Node.js 24 compatibility

Scripts — Storage, Hardware and GPU/TPU Work

This release also consolidates significant work on the core ProxMenux scripts.

Storage

• SMART scheduled tests and improved interactive SMART test workflow
• Disk formatting rework (format-disk.sh) with safer device selection
• Disk passthrough for VMs and CTs — updated device enumeration, serial-based identification, cleaner teardown
• NVMe controller addition for VMs — improved controller type selection and slot detection
• Import disk image — smoother path validation and progress reporting
• Disk & storage manual guide refresh

Hardware / GPU / TPU

• Coral TPU installer updated for current kernels and udev rules (Proxmox VE 8 & VE 9)
• NVIDIA installer — cleaner driver installation, kernel header handling, VM/LXC attachment flow
• GPU mode switch (direct and interactive variants) — safer switching between iGPU modes
• Add GPU to VM / LXC — unified selection dialogs and permission handling
• Intel / AMD GPU tools kept in sync with the new shared patterns
• Hardware & graphics menu restructured for consistency

UI Flow Consistency
All recently-touched scripts follow the unified msg_info / stop_spinner / show_proxmenux_logo pattern between dialog menus and during the main execution phase — cleaner transitions and no more spinner artifacts over dialogs.

📦 Current project structure

ProxMenux is organized into modular, interactive menus designed for managing and customizing a Proxmox VE system:

1. Post-Install Settings for Proxmox
2. Hardware: GPU and Coral TPU Tools
3. Create VMs from Templates or Scripts
4. Disk and Storage Manager
5. Mount and Share Manager
6. Essential Proxmox VE Helper Scripts
7. Network Tools and Tweaks
8. System Settings and Optimization
9. Help and Info Commands
10. ProxMenux Monitor

Thank you for using ProxMenux!
Feel free to report issues or suggest improvements — all contributions are welcome 🙌.