✅ Summary of Changes from the Initial Version 🧩 1. Tag-Based Filtering (Core Feature) New feature: Only restart instances (VMs or containers) that have the mon-restart tag. This makes monitoring and auto-restart controllable directly from the Proxmox Web UI, without editing scripts or services. Set via GUI: VM → Options → Tags → mon-restart Set via CLI: qm set <vmid> -tags mon-restart or pct set <ctid> -tags mon-restart This is the primary new control mechanism, making the script safer, more flexible, and user-friendly. 🧰 2. Backward-Compatible Exclusion Mechanism The original feature that lets you exclude instances via CLI arguments is preserved: bash Copy Edit ./ping-instances.sh 101 300 These IDs will always be skipped regardless of tag. 🧠 3. Intelligent Responsiveness Checks For VMs: Uses qm guest cmd <id> ping to check responsiveness via the QEMU guest agent. No longer relies on network-level ping, which can be misleading or blocked. For containers (CTs): Uses traditional ping to IP addresses obtained from pct exec, since CTs don’t support QEMU agent. ⛔ 4. Instance Skipping Improvements Instances are now skipped if: They are explicitly excluded via CLI. They are templates. They are configured with onboot: 0 or missing. They lack the mon-restart tag, regardless of other status. 🪵 5. Same Logging Behavior All output continues to go to /var/log/ping-instances.log for persistent tracking. Verbose messages were added for traceability (e.g., why a VM or CT was skipped). 🎯 Why This Matters With tag-based control, admins can now manage restart behavior dynamically from the Proxmox Web UI, making the script: More secure (no accidental restarts). More maintainable (no script edits needed). More user-friendly (integrated with the UI workflow).
🚀 Project Overview
Proxmox VE Helper-Scripts is a collection of tools to simplify the setup and management of Proxmox Virtual Environment (VE). Originally created by tteck, these scripts are now continued by the community. Our goal is to preserve and expand upon tteck's work, providing an ongoing resource for Proxmox users worldwide.
📦 Features
- Interactive Setup: Choose between simple and advanced options for configuring VMs and LXC containers.
- Customizable Configurations: Advanced setup for fine-tuning your environment.
- Seamless Integration: Works seamlessly with Proxmox VE for a smooth experience.
- Community-driven: Actively maintained and improved by the Proxmox community.
✅ Requirements
Ensure your system meets the following prerequisites:
- Proxmox VE version: 8.x or higher
- Linux: Compatible with most distributions
- Dependencies: bash and curl should be installed.
🚀 Installation
To install the Proxmox Helper Scripts, follow these steps:
- Visit the Website.
- Search for the desired script, e.g., "Home Assistant OS VM".
- Copy the provided Bash command from the "How To Install" section.
- Open the Proxmox shell on your main node and paste the command.
- Press enter to start the installation! 🚀
❤️ Community and Contributions
We appreciate any contributions to the project—whether it's bug reports, feature requests, documentation improvements, or spreading the word. Your involvement helps keep the project alive and sustainable.
💖 Donate to Support the Project
- Ko-Fi for Community Edition: Donate to support this project – Donations go towards maintaining the project, testing infrastructure, and charity (cancer research, hospice care). 30% of the funds will be donated to charity.
💬 Get Help
Join our community for support:
- Discord: Join our Proxmox Helper Scripts Discord server for real-time support.
- GitHub Discussions: Ask questions or report issues.
🤝 Report a Bug or Feature Request
If you encounter any issues or have suggestions for improvement, file a new issue on our GitHub issues page. You can also submit pull requests with solutions or enhancements!
⭐ Star History
📜 License
This project is licensed under the MIT License.
Proxmox® is a registered trademark of Proxmox Server Solutions GmbH.