Werk #20012: Proxmox VE: Add guided Quick Setup
| Component | Setup | ||
| Title | Proxmox VE: Add guided Quick Setup | ||
| Date | Jun 17, 2026 | ||
| Level | Prominent Change | ||
| Class | New Feature | ||
| Compatibility | Compatible - no manual interaction needed | ||
| Checkmk versions & editions |
|
You can now set up Proxmox VE monitoring through a guided Quick Setup, found under Setup > Quick Setup next to the existing cloud setups (AWS, Azure, GCP).
What does this mean?
Instead of creating a host and configuring the Proxmox VE special agent rule by hand, the Quick Setup walks you through it in three steps:
- Name the configuration and choose where the host and its VMs are created.
- Enter the credentials of a dedicated Proxmox VE API user, with inline guidance on which realm and permissions (Role: PVEAuditor, Path: /) the user needs.
- Review the configuration and run a connection and preview service discovery test before saving.
When you save, the Quick Setup creates the host and the Proxmox VE special agent configuration for you, ready to activate.
Connection test
The Quick Setup verifies your credentials before saving. For this, the Proxmox
VE special agent now accepts a --connection-test option that authenticates
against the Proxmox VE API and exits without fetching any monitoring data.
Technical background
This feature is based on the community extension "Proxmox Quick Setup & Dashboard" by comNET GmbH (https://github.com/comnetgmbh/proxmox_quick_setup), mainlined into Checkmk. The form definitions of the Proxmox VE special agent ruleset are now shared with the Quick Setup, so both stay in sync. Your existing Proxmox VE configurations keep working unchanged; the only visible difference in the standard ruleset is a new input hint ("username@realm") on the username field.