Subscribe to our RSS feed to get notified of new changes.
https://proxmenux.com/rss.xml
This release is the culmination of the v1.1.9.1 → v1.1.9.6 beta cycle and introduces the biggest evolution of ProxMenux Monitor to date: AI-enhanced notifications, a redesigned multi-channel notification system, a fully 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.
Notifications can now be enhanced using AI to generate clear, contextual messages instead of raw technical output.
Example — instead of backup completed exitcode=0 size=2.3GB, AI produces: "The web server backup completed successfully. Size: 2.3GB".
Choose between 6 AI providers, each with its own API key stored independently:
A curated list of models (verified_ai_models.json) tested specifically for notification enhancement.
| Provider | Recommended | Also Verified |
|---|---|---|
| Gemini | gemini-2.5-flash-lite | gemini-flash-lite-latest |
| OpenAI | gpt-4o-mini | gpt-4.1-mini |
| Groq | llama-3.3-70b-versatile | llama-3.1-70b-versatile, llama-3.1-8b-instant, llama3-70b-8192, llama3-8b-8192, mixtral-8x7b-32768, gemma2-9b-it |
| Anthropic | claude-3-5-haiku-latest | claude-3-5-sonnet-latest, claude-3-opus-latest |
| OpenRouter | meta-llama/llama-3.3-70b-instruct | meta-llama/llama-3.1-70b-instruct, anthropic/claude-3.5-haiku, google/gemini-flash-2.5-flash-lite, openai/gpt-4o-mini, mistralai/mixtral-8x7b-instruct |
| Ollama | (all local models) | No filtering — shows all installed models |
Advanced users can define their own prompt for full control over formatting and translation.
Send notifications to a specific topic inside groups with Topics enabled.
The Monitor now detects when a new ProxMenux version is released.
version.txt) and beta (beta_version.txt)config.json, reset by update scriptsThe Hardware page has been significantly expanded, with better detection and richer per-device detail.
lspci, lspci -vmm) — 5 min cache avoids repeated scans for data that doesn't changeThe Storage Overview has been reworked around real-time state and user-controlled tracking.
worst_health tracking that required manual clearingvmbr, bonds, physical NICs, VLANs) from health and notifications; ideal for intentionally disabled interfaces that would otherwise generate false alertsErrors for resources that no longer exist are now resolved automatically.
The VM/CT detail modal has been completely redesigned for usability.
Major reduction in CPU usage and elimination of spikes on the Monitor.
Collectors now run on offset schedules to prevent simultaneous execution:
| Collector | Schedule |
|---|---|
| CPU sampling | Every 30s at offset 0 |
| Temperature sampling | Every 15s at offset 7s |
| Latency pings | Every 60s at offset 25s |
| Temperature record | Every 60s at offset 40s |
| Health collector | Starts at 55s offset |
| Notification polling | Health=10s, Updates=30s, ProxMenux=45s, AI=50s |
Expensive commands now cached to reduce repeated execution:
| Command | Cache TTL | Impact |
|---|---|---|
pveversion | 6 hours | Eliminates 23%+ CPU spikes from Perl execution |
apt list --upgradable | 6 hours | Reduces package manager queries |
pvesh get /cluster/resources | 30 seconds | 6 API calls per request reduced to 1 |
sensors | 10 seconds | Temperature readings cached between polls |
smartctl (SMART health) | 30 minutes | Disk health checks reduced from every 5 min |
lspci / lspci -vmm | 5 minutes | Hardware info cached (doesn't change) |
journalctl --since 24h | 1 hour | Login attempts count cached (92% reduction) |
Prevents timeout cascades under system load:
| Query Type | Before | After |
|---|---|---|
| Short-term (3-10 min) | 3s | 10s |
| Medium-term (1 hour) | 5s | 15s |
| Long-term (24 hours) | 5s | 20s |
TaskWatcher interval raised from 2s → 5s (60% fewer checks)This release also consolidates significant work on the core ProxMenux scripts.
format-disk.sh) rework with safer device selection and dialog flowHelper Scripts Menu — Full Catalog Rebuild The Helper Scripts catalog has been completely rebuilt to adapt to the new data architecture of the Community Scripts project.
The previous implementation relied on a metadata.json file that no longer exists in the upstream repository. The catalog now connects directly to the PocketBase API (db.community-scripts.org), which is the new official data source for the project.
A new GitHub Actions workflow generates a local helpers_cache.json index that replaces the old metadata dependency. This new cache is richer, more structured, and includes:
git.community-scripts.org) for every scriptScripts that support multiple OS variants (e.g. Docker with Alpine and Debian) now correctly show one entry per OS, each with its own GitHub and Mirror download option — restoring the behavior that existed before the upstream migration.
This update would not have been possible without the openness and collaboration of the Community Scripts maintainers.
When the upstream metadata structure changed and broke the ProxMenux catalog, the maintainers responded quickly, explained the new architecture in detail, and provided all the information needed to rebuild the integration cleanly.
Special thanks to:
script_scripts, script_categories).The Helper Scripts project is an extraordinary resource for the Proxmox community. The scripts belong entirely to their authors and maintainers — ProxMenux simply offers a guided way to discover and launch them. All credit goes to the community behind community-scripts/ProxmoxVE.
Offline Execution Mode (no GitHub dependency)
All ProxMenux core scripts now run entirely locally, without requiring live requests to GitHub (raw.githubusercontent.com).
This change provides:
⚠️ This update resolves recent issues where users in certain regions were unable to run scripts due to CDN or TLS filtering errors while downloading .sh files from GitHub raw URLs.
🎖 Special Acknowledgment: @cod378
This offline conversion has been made possible thanks to the extraordinary work of @cod378,
who redesigned the entire internal logic of the installer and updater, refactored the file management system,
and implemented the new fully local execution workflow.
Without his collaboration, dedication, and technical contribution, this transformation would not have been possible.
ProxMenux Monitor v1.0.1
This update brings a major leap in the ProxMenux Monitor interface.
New features and improvements:
Proxy Support: Access ProxMenux through reverse proxies with full functionalityAuthentication System: Secure your dashboard with password protectionTwo-Factor Authentication (2FA): Optional TOTP support for enhanced securityPCIe Link Speed Detection: View NVMe connection speeds and detect performance bottlenecksEnhanced Storage Display: Auto-formats disk sizes (GB → TB when appropriate)SATA/SAS Interface Info: Detect and show storage type (SATA, SAS, NVMe, etc.)Health Monitoring System: Built-in system health check with dismissible alertsHelper Scripts Menu (Mirror Support)
The Helper Scripts menu now:
ProxMenux Monitor
Your new monitoring tool for Proxmox. Discover all the features that will help you manage and supervise your infrastructure efficiently.
ProxMenux Monitor is designed to support future updates where actions can be triggered without using the terminal, and managed through a user-friendly interface accessible across multiple formats and devices.
Access it at: http://your-server-ip:8008
New Banner Removal Method
A new function to disable the Proxmox subscription message with improved safety:
Special thanks to @eryonki for providing the improved method.
CORAL TPU Installer Updated for PVE 9
The CORAL TPU driver installer now supports both Proxmox VE 8 and VE 9, ensuring compatibility with the latest kernels and udev rules.
Log2RAM Installation & Integration
journald configuration to align with the size and behavior of Log2RAM.Network Optimization Function (LXC + NFS)
Improved to prevent “martian source” warnings in setups where LXC containers share storage with VMs over NFS within the same server.
APT Upgrade Progress
When running full system upgrades via ProxMenux, a real-time progress bar is now displayed, giving the user clear visibility into the update process.
New Menu: Mount and Share Manager
Introduced a comprehensive new menu for managing shared resources between Proxmox host and LXC containers:
Host Configuration Options:
LXC Integration Options:
Documentation & Support:
The entire system is built around the LXC Mount Points functionality, which automatically detects filesystem types, handles permission mapping between host and container users, and provides seamless integration for both privileged and unprivileged containers.
Proxmox Update Repository Verification
Fixed an issue in the Proxmox update function where empty repository source files would cause errors during conflict verification. The function now properly handles empty /etc/apt/sources.list.d/ files without throwing false warnings.
Thanks to @JF_Car for reporting this issue.
Special thanks to @JF_Car, @ghosthvj, and @jonatanc for their testing, valuable feedback, and suggestions that helped refine the shared resources functionality and improve the overall user experience.
New Script: Upgrade PVE 8 to PVE 9
Added a full upgrade tool located under Utilities and Tools. It provides:
check-pve8to9New Tools in System Utilities
s-tui: Terminal-based CPU monitoring with graphsintel-gpu-tools: Useful for Intel GPU diagnosticsAPT Upgrade Handling
The PVE upgrade function now blocks the process if any package prompts for manual confirmation. This avoids partial upgrades and ensures consistency.
Network Optimization (sysctl)
tcp_tw_recycle, nf_conntrack_helper) to prevent warnings in Proxmox 9 / kernel 6.14AMD CPU Patch Handling
idle=nomwait and KVM options (ignore_msrs=1, report_ignored_msrs=0)Timezone & NTP Fixes
/var/spool/postfix/etc/localtime mismatch warningRepository & Package Installer Logic
mlocate with plocate (compatible with Debian 13 and Proxmox 9)Improved Logs and User Feedback
Proxmox 9 Compatibility Preparation
This version prepares ProxMenux for the upcoming Proxmox VE 9:
.sources format used in Proxmox 9, while maintaining backward compatibility with Proxmox 8.xshok-proxmox Detection
Added a check to detect if the xshok-proxmox post-install script has already been executed.
If detected, a warning is shown to avoid conflicting adjustments:
Banner Removal (Proxmox 8.4.9+)
Updated the logic for removing the subscription banner in Proxmox 8.4.9, due to changes in proxmoxlib.js.
LXC Disk Passthrough (Persistent UUID)
The function to add a physical disk to an LXC container now uses UUID-based persistent paths.
This ensures that disks remain correctly mounted, even if the /dev/sdX order changes due to new hardware.
System Utilities Installer
Now checks whether APT sources are available before installing selected tools.
If a new Proxmox installation has no active repos, it will automatically add the default sources to avoid installation failure.
IOMMU Activation on ZFS Systems
The function that enables IOMMU for passthrough now verifies existing kernel parameters to avoid duplication if the user has already configured them manually.
Subscription Banner Removal (Proxmox 8.4.5+)
Improved the remove_subscription_banner function to ensure compatibility with Proxmox 8.4.5, where the banner removal method was failing after clean installations.
Improved Log2RAM Detection
In both the automatic and customizable post-install scripts, the logic for Log2RAM installation has been improved.
Now it correctly detects if Log2RAM is already configured and avoids triggering errors or reconfiguration.
Optimized Figurine Installation
The install_figurine function now avoids duplicating .bashrc entries if the customization for the root prompt already exists.
New Function: Persistent Network Interface Naming
Added a new function setup_persistent_network to create stable network interface names using .link files based on MAC addresses.
This avoids unpredictable renaming (e.g., enp2s0 becoming enp3s0) when hardware changes, PCI topology shifts, or passthrough configurations are applied.
Why use .link files?
Because predictable interface names in systemd can change with hardware reordering or replacement. Using static .link files bound to MAC addresses ensures consistency, especially on systems with multiple NICs or passthrough setups.
Special thanks to [@Andres_Eduardo_Rojas_Moya] for contributing the persistent
network naming function and for the original idea.
Dual Installation Modes for ProxMenux
The installer now offers two distinct modes:
dialog, jq) to enable menus and JSON parsing. No files are written beyond the configuration directory.When updating, if the user switches from full to lite, the old version will be automatically removed for a clean transition.
New Script: Automated Post-Installation Setup
A new minimal post-install script that performs essential setup automatically:
.bashrc tweaks and Log2RAM auto-install (if SSD/M.2 is detected)New Function: Log2RAM Configuration
Now available in both the customizable and automatic post-install scripts.
On systems with SSD/NVMe, Log2RAM is enabled automatically to preserve disk life.
New Menus:
Post-Install Menu Logic
Options are now grouped more logically for better usability.
VM Creation Menu
Enhanced with improved CPU model support and custom options.
UUP Dump ISO Creator Script
Physical Disk to LXC Script
Now handles XFS-formatted disks correctly.
Thanks to @antroxin for reporting and testing!
System Utilities Installer
Rewritten to verify command availability after installation, ensuring tools work as expected.
🐛 Fix for #18 by @DST73
New Menu: Proxmox PVE Helper Scripts
Officially introduced the new Proxmox PVE Helper Scripts menu, replacing the previous: Esenciales Proxmox.
This new menu includes:
It’s a cleaner, faster, and more functional way to access community scripts in Proxmox.
New CPU Models in VM Creation
The CPU selection menu in VM creation has been greatly expanded to support advanced QEMU and x86-64 CPU profiles.
This allows better compatibility with modern guest systems and fine-tuning performance for specific workloads, including nested virtualization and hardware-assisted features.
Thanks to @Nida Légé (Nidouille) for suggesting this enhancement.
Support for .raw Disk Images
The disk import tool for VMs now supports .raw files, in addition to .img, .qcow2, and .vmdk.
This improves compatibility when working with disk exports from other hypervisors or backup tools.
💡 Suggested by @guilloking in GitHub Issue #5
Locale Detection in Language Skipping
The function that disables extra APT languages now includes:
LANG)en_US.UTF-8 if none is foundAPT Language Skipping Logic
Improved locale handling ensures system compatibility before disabling translations:
System Update Speed
Post-install system upgrades are now faster:
dist-upgrade) is separated from container template index updates.Faster Dialog Menu Transitions
Improved UI responsiveness across all interactive menus by replacing whiptail with dialog, offering faster transitions and smoother navigation.
Coral USB Support in LXC
Improved the logic for configuring Coral USB TPU passthrough into LXC containers:
/dev/coral) and Coral M.2 (/dev/apex_0) logic./dev/coral symbolic link.Persistent Coral USB Passthrough Support
Added udev rule support for Coral USB devices to persistently map them as /dev/coral, enabling consistent passthrough across reboots. This path is automatically detected and mapped in the container configuration.
RSS Feed Integration
Added support for generating an RSS feed for the changelog, allowing users to stay informed of updates through news clients.
Release Service Automation
Implemented a new release management service to automate publishing and tagging of versions, starting with version v1.1.2.
/usr/local/bin directory, causing errors when installing the execution menu. The script now creates the directory if it does not exist before downloading the main menu.Updated Lynis Installation Logic in Post-Install Settings
The install_lynis() function was improved to always install the latest version of Lynis by cloning the official GitHub repository:
The installation process now ensures the latest version is always fetched and linked properly within the system path.
Thanks to @Kamunhas for reporting this enhancement opportunity.
Balanced Memory Optimization for Low-Memory Systems
Improved the default memory settings to better support systems with limited RAM. The previous configuration could prevent low-spec servers from booting. Now, a more balanced set of kernel parameters is used, and memory compaction is enabled if supported by the system.
These values help maintain responsiveness and system stability even under constrained memory conditions.
Thanks to @chesspeto for pointing out this issue and helping refine the optimization.
Interactive Help & Info Menu
Added a new script called Help and Info, which provides an interactive command reference menu for Proxmox VE through a dialog-based interface.
This tool offers users a quick way to browse and copy useful commands for managing and maintaining their Proxmox server, all in one centralized location.
Figure 1: Help and Info interactive command reference menu.
Uninstaller for Post-Install Utilities
A new script has been added to the Post-Installation menu, allowing users to uninstall utilities or packages that were previously installed through the post-install script.
Utility Selection Menu in Post-Installation Script
The Install Common System Utilities section now includes a menu where users can choose which utilities to install, instead of installing all by default. This gives more control over what gets added to the system.
Old PV Header Detection and Auto-Fix
After updating the system, the post-update script now includes a security check for physical disks with outdated LVM PV (Physical Volume) headers.
This issue can occur when virtual machines have passthrough access to disks and unintentionally modify volume metadata. The script now detects and automatically updates these headers.
If any error occurs during the process, a warning is shown to the user.
Faster Translations in Menus
Several post-installation menus with auto-translations have been optimized to reduce loading times and improve user experience.
Improved the logic for detecting physical disks in the Disk Passthrough to a VM script. Previously, the script would display disks that were already mounted in the system on some setups. This update ensures that only unmounted disks are shown in Proxmox, preventing confusion and potential conflicts.
This improvement ensures that disks already mounted or assigned to other VMs are excluded from the list of available disks, providing a more accurate and reliable selection process.
Create Synology DSM VM:
A new script that creates a VM to install Synology DSM. The script automates the process of downloading three different loaders with the option to use a custom loader provided by the user from the local storage options.
Additionally, it allows the use of both virtual and physical disks, which are automatically assigned by the script.
Figure 1: Synology DSM VM setup overview.
New VM Creation Menu:
A new menu has been created to enable VM creation from templates or custom scripts.
Main Menu Update:
Added a new entry to the main menu for accessing the VM creation menu from templates or scripts.
jq (for handling JSON data)googletrans) (for multi-language support)