MacRimi
73389d842a
Pedro Rico, 19/05: after reinstalling the Monitor from GitHub a real SSH/web login failure went unnotified. Root cause was the auth_fail cooldown surviving across the service restart — install_proxmenux_beta extracts the new AppImage but leaves the notification_last_sent SQLite table intact (desirable: we don't want to lose legitimate cooldowns on every update). On startup `_load_cooldowns_from_db()` then loaded the stale auth_fail row from the previous run into the in-memory cache, and `_passes_cooldown` blocked the new event. This extends the existing reset-on-start mechanism (already in place for update_summary, proxmenux_update, post_install_update, …) to also clear auth_fail rows. A security-relevant event shouldn't be silenced because the same source IP happened to fail to log in yesterday. - Rename `_UPDATE_EVENT_TYPES_RESET_ON_START` → `_EVENT_TYPES_RESET_ON_START` (the list no longer covers only update-status reports). - Rename `_reset_update_cooldowns_on_start()` → `_reset_cooldowns_on_start()` for the same reason. - Add `'auth_fail'` to the curated list. High-frequency sources (log_critical_*, disk SMART errors, …) are deliberately NOT on this list — they keep their 24h cooldown across restarts to prevent inbox floods if the user toggles the service. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ProxMenux is a management tool for Proxmox VE that simplifies system administration through an interactive menu, allowing you to execute commands and scripts with ease.
📌 Installation
To install ProxMenux, simply run the following command in your Proxmox server terminal:
bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)"
⚠️ Be careful when copying scripts from the internet. Always remember to check the source!
📄 You can review the source code before execution.
🛡️ All executable links follow our Code of Conduct.
📌 How to Use
Once installed, launch ProxMenux by running:
menu
Then, follow the on-screen options to manage your Proxmox server efficiently.
🧪 Beta Program
Want to try the latest features before the official release and help shape the final version?
The ProxMenux Beta Program gives early access to new functionality — including the newest builds of ProxMenux Monitor — directly from the develop branch. Beta builds may contain bugs or incomplete features. Your feedback is what helps fix them before the stable release.
Install the beta version:
bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/develop/install_proxmenux_beta.sh)"
What to expect:
- You'll get new features and Monitor builds before anyone else
- Some things may not work perfectly — that's expected and normal
- When a stable release is published, ProxMenux will notify you on the next
menulaunch and offer to switch automatically
How to report issues:
Open a GitHub Issue and include:
- What you did and what you expected to happen
- Any error messages shown on screen
- Logs from the Monitor if relevant:
journalctl -u proxmenux-monitor -n 50
💙 Thank you for being part of the beta program. Your help makes ProxMenux better for everyone.
🖥️ ProxMenux Monitor
ProxMenux Monitor is an integrated web dashboard that provides real-time visibility into your Proxmox infrastructure — accessible from any browser on your network, without needing a terminal.
What it offers:
- Real-time monitoring of CPU, RAM, disk usage and network traffic
- Overview of running VMs and LXC containers with status indicators
- Login authentication to protect access
- Two-Factor Authentication (2FA) with TOTP support
- Reverse proxy support (Nginx / Traefik)
- Designed to work across desktop and mobile devices
Access:
Once installed, the dashboard is available at:
http://<your-proxmox-ip>:8008
The Monitor is installed automatically as part of the standard ProxMenux installation and runs as a systemd service (proxmenux-monitor.service) that starts automatically on boot.
Useful commands:
# Check service status
systemctl status proxmenux-monitor
# View logs
journalctl -u proxmenux-monitor -n 50
# Restart the service
systemctl restart proxmenux-monitor
🔧 Dependencies
The following dependencies are installed automatically during setup:
| Package | Purpose |
|---|---|
dialog |
Interactive terminal menus |
curl |
Downloads and connectivity checks |
jq |
JSON processing |
git |
Repository cloning and updates |
python3 + python3-venv |
Translation support (Translation version only) |
googletrans |
Google Translate library (Translation version only) |
🛡️ Security Note / VirusTotal False Positive If you scan the raw installation URL on VirusTotal, you might see a 1/95 detection by heuristic engines like Chong Lua Dao. This is a known false positive. Because this script uses the standard
curl | bashinstallation pattern and downloads legitimate binaries (likejqfrom its official GitHub release), overly aggressive scanners flag the behavior. The script is 100% open source and safe to review. You can read more about this in Issue #162.
⭐ Support the Project!
If you find ProxMenux useful, consider giving it a ⭐ on GitHub to help others discover it!
🤝 Contributing
Contributions, bug reports and feature suggestions are welcome!
Star History
Support the project on Ko-fi!