Proxmox VE Capabilities
Explore the features currently available through StackConsole CMP, understand the infrastructure prerequisites, and identify limitations and additional configuration requirements.
StackConsole CMP provides selected capabilities of the underlying infrastructure platform. Native platform capabilities are not automatically available through CMP.
Need to connect a Proxmox cluster, map zones, configure storage, or define rate cards? Start with Connecting CMP to Proxmox and Proxmox Packages.
1. Proxmox VE Capability Explorer
| Feature | Module | CMP Support Status ▲ | Short Description | Details |
|---|---|---|---|---|
Additional Volume Creation# | Volume Management | Supported | Allows customers to order and provision standalone block storage volumes. | |
Attach Additional Volume# | Volume Management | Supported | Attaches a secondary block volume to a running or stopped VM. | |
Backup Deletion# | Backup & Recovery | Supported | Deletes backup archives from local datastore or PBS repository. | |
Change Hostname / Server Label# | VM Lifecycle | Supported | Updates CMP display label and synchronizes internal VM description. | |
CMP-Level IPAM Pools# | IPAM | Supported | CMP-native IPAM manages subnets, gateways, DNS, and IP allocations. | |
CPU Cores & Sockets Detection# | VM Import | Supported | Reads CPU core count and maps instance to closest CMP VM package. | |
Firewall Rule Import# | VM Import | Supported | Discovers and imports existing VM firewall rules into CMP during VM onboarding. | |
Immediate Billing Activation# | VM Import | Supported | Initiates resource billing immediately upon VM import confirmation. | |
Import Existing Bridges# | Networking | Supported | Synchronizes pre-configured Linux bridges from Proxmox hosts into CMP. | |
Import Existing VM# | VM Import | Supported | Imports unmanaged Proxmox VMs into CMP customer projects and billing. | |
Inbound Rule Creation# | Firewall | Supported | Defines ingress rules filtering by protocol, source IP, and port ranges. | |
IP Address Detection# | VM Import | Supported | Detects active IP address via QEMU Guest Agent or assigns from CMP IPAM. | |
IP Allocation to VM# | IPAM | Supported | Assigns IP address automatically from pool during VM provisioning. | |
IP Tracking & Reclamation# | IPAM | Supported | Releases IP address back to pool immediately upon VM deletion. | |
Local Storage Backup# | Backup & Recovery | Supported | Full VM archive creation saved to local Proxmox datastores. | |
Memory / RAM Detection# | VM Import | Supported | Detects assigned RAM and maps instance to closest CMP package profile. | |
Network Assignment to VM# | Networking | Supported | Attaches virtio network interface to VM linked to synchronized bridge. | |
Outbound Rule Creation# | Firewall | Supported | Filters outbound egress destinations and protocols from the instance. | |
Password Import# | VM Import | Supported | Imports and registers administrative guest credentials during VM onboarding into CMP. | |
Proxmox Backup Server (PBS)# | Backup & Recovery | Supported | Enterprise deduplicated, incremental, encrypted backups to PBS. | |
Proxmox VM Firewall Rules# | Firewall | Supported | Manages inbound and outbound packet filtering via native Proxmox firewall. | |
Resource-Based Billing# | VM Lifecycle | Supported | Automated hourly and monthly billing synchronization for instances and add-ons. | |
Root Disk Creation# | Volume Management | Supported | Provisions standard root OS disk on configured storage pool (e.g. local-zfs or custom datastore). | |
Rule Deletion & Lifecycle# | Firewall | Supported | Flushes and updates active firewall rules immediately via API. | |
Scheduled VM Backups# | Backup & Recovery | Supported | Automated recurring backup jobs executed at defined intervals. | |
SSH Port Configuration# | VM Import | Supported | Defaults to port 22; configurable during import if custom port is used. | |
Storage & Volume Mapping# | VM Import | Supported | Maps root disk and secondary attached volumes to CMP storage records. | |
Total Disk Capacity Calculation# | VM Import | Supported | Aggregates all attached disk sizes for total storage billing. | |
VM Creation# | VM Lifecycle | Supported | Automated VM provisioning via cloud-init templates and VM packages. | |
VM Deletion# | VM Lifecycle | Supported | Permanently deletes instance, purges attached disks, and terminates billing. | |
VM Name & Hostname Detection# | VM Import | Supported | Detects Proxmox VM name and maps it to CMP service label. | |
VM Plan Change# | VM Lifecycle | Supported | Upgrades or downgrades assigned vCPU cores and memory allocation. | |
VM Restart# | VM Lifecycle | Supported | Reboots the virtual machine via ACPI with automated fallback to hard reboot. | |
VM Restore# | Backup & Recovery | Supported | Restores virtual machine state from local storage or PBS backup archive. | |
VM Shutdown# | VM Lifecycle | Supported | Graceful operating system shutdown using ACPI or QEMU Guest Agent. | |
VM Start# | VM Lifecycle | Supported | Powers on a stopped virtual machine instance. | |
VM Stop# | VM Lifecycle | Supported | Immediate hard power-off for instances via the Proxmox API. | |
Volume Deletion# | Volume Management | Supported | Permanently deletes standalone block volume and cancels asset billing. | |
Dedicated Backup Storages# | Backup & Recovery | Configurable | Configure multiple backup destinations managed by CMP selection algorithm. | |
Multiple VM Storage Pools# | Volume Management | Configurable | Enables multi-pool storage tiering evaluated via CMP selection algorithm. | |
Associated IP (Public Mapping)# | IPAM | Conditional | Maps public IP to private VM for portal tracking; edge router routes traffic. | |
Detach Volume# | Volume Management | Conditional | Detaches secondary block volume; requires unmounting filesystem first. | |
Login Username Tracking# | VM Import | Conditional | Records default login username for customer portal connection display. | |
Multi-Node Storage Compatibility# | Volume Management | Conditional | Requires shared storage (Ceph RBD/NFS) for dynamic multi-node VM placement. | |
PBS API Permissions# | Backup & Recovery | Conditional | Requires PVEDatastoreAdmin and PVEVMAdmin roles on Proxmox and PBS. | |
VM Password Reset# | VM Lifecycle | Conditional | Resets the guest administrative password when compatible guest tools are installed. | |
Proxmox SDN Management# | Networking | Under Development | Native Proxmox SDN integration is actively being developed for future releases. | |
Automated NAT / Port Forwarding# | Networking | Not Supported | Automated perimeter NAT and edge port forwarding are not managed by CMP. | |
Create Network from CMP# | Networking | Not Supported | Creating new physical or virtual bridges from CMP UI is not supported. | |
Edge Port Forwarding# | Firewall | Not Supported | Perimeter gateway translation is external and not managed by CMP firewall. | |
Resize Volume# | Volume Management | Not Supported | Volume resizing is not supported through CMP; volume disk capacity cannot be expanded. | |
Security Groups# | Firewall | Not Supported | Reusable cluster security group templates are not exposed in CMP portal. | |
VM Web Console# | VM Lifecycle | Not Supported | In-browser noVNC/SPICE console is not exposed directly in CMP customer portal. | |
Volume Snapshots# | Volume Management | Not Supported | Standalone volume snapshots are not supported in CMP; use VM-level snapshots instead. |
2. Core Operational Invariants & Platform Rules
The following non-negotiable architectural rules govern the Proxmox integration in StackConsole CMP:
2.1 Storage Configuration & Selection Algorithm
- Configured VM Root Storage: Any valid Proxmox storage pool can be configured for VM root disk provisioning (
local-zfsis a common default example, but providers can use any storage pool name configured in their environment). - Multiple Storage Settings: Providers can add multiple storage settings in CMP under Settings → Orchestrator → Storage Settings.
- Automated Storage Selection: When multiple storages are configured, CMP calculates storage capacity and load via its storage selection algorithm to deploy the VM disk on the optimal storage pool.
- Multi-Node Shared Storage Prerequisite:
- Local storage is strictly node-specific. A local storage pool (such as
local-zfson Node A) cannot be accessed by Node B. - If a Proxmox cluster has multiple nodes, shared storage (Ceph RBD, NFS, iSCSI) must be configured if VMs are expected to migrate or provision dynamically across nodes.
- Node placement must be compatible with the selected storage pool.
- Local storage is strictly node-specific. A local storage pool (such as
2.2 Node Placement (No Proxmox DRS Dependency)
- Native Proxmox VE does not include a Distributed Resource Scheduler (DRS).
- CMP provides built-in automated node selection at provision time, evaluating node RAM, CPU load, and storage availability before dispatching the
qm createAPI call.
2.3 Backup Storage & PBS Integration Rules
- Dedicated Backup Storage: CMP supports configuring dedicated backup storages in Cloud Provider Setup.
- Multiple Backup Destinations: When multiple backup storages are configured, CMP's storage selection algorithm chooses the best available destination.
- Supported Backup Targets:
- Local Proxmox Storage:
vzdumparchives saved directly to local Proxmox datastores. - Proxmox Backup Server (PBS): Enterprise deduplicated, incremental backup target.
- Local Proxmox Storage:
- Mandatory PBS API Permissions: The Proxmox API user configured in CMP must possess adequate permissions on both the cluster and the PBS datastore:
PVEDatastoreAdminon/storagePVEVMAdminon/vms
- Scheduled Backups: VM backup schedules configured in CMP execute automated background snapshots at defined intervals.
2.4 VM Import Commercial & Lifecycle Boundaries
- Service Creation: Importing an existing Proxmox VM immediately creates an active customer service record in CMP.
- Immediate Billing: Resource-based billing begins immediately upon import based on the mapped VM and volume packages.
- Zero Configuration Mutation: CMP does not alter existing guest operating system files, kernel settings, or disk partitions during import.
- Full Post-Import Management: Imported VMs can be powered on/off, restarted, resized, backed up, and deleted directly through CMP.
- Duplicate Protection: If a VM ID (
vmid) is already mapped to an existing active CMP service, re-importing is blocked to prevent database collision.
3. Feature Requests vs. Production Incidents
To prevent operational confusion after going live:
- Documented Scope as Source of Truth: The capabilities marked as
Supportedin the matrix above define the complete current scope of the StackConsole Proxmox integration. - Platform Gaps are Not Defects: Native Proxmox features that are not currently exposed in CMP (e.g. noVNC web console, automated perimeter NAT, native SDN, Proxmox security groups) are feature gaps, not production bugs or outages.
- Emergency Support Boundaries: Support tickets should be opened for functional defects within supported capabilities (e.g. failure of configured storage provisioning, power action failures, billing sync mismatches). Tickets raised demanding immediate implementation of unreleased features cannot be treated as production defects.
Custom Development Request Process
StackConsole welcomes customer-driven roadmap prioritization. If a cloud provider requires a capability not currently supported:
4. Customer Onboarding & Go-Live Readiness Checklist
Before moving a Proxmox integration into live commercial production, validate every checkpoint across the three responsible parties:
| Validation Area | Specific Checkpoint | Responsible Party | Verification Status |
|---|---|---|---|
| API Connectivity | CMP can reach Proxmox API port 8006 over private network or VPN | Cloud Provider | [ ] Verified |
| API Permissions | User belongs to UserAdmin group with Administrator, PVEVMAdmin, PVEDatastoreAdmin | Cloud Provider | [ ] Verified |
| Templates | CMP-compatible cloud-init template prepared with QEMU Guest Agent enabled | Cloud Provider | [ ] Verified |
| Storage (Single Node) | Configured storage setting (e.g. local-zfs or custom pool) verified and active in CMP | Cloud Provider / StackConsole | [ ] Verified |
| Storage (Multi-Node) | Shared storage (Ceph RBD / NFS) verified across all cluster nodes if multi-node | Cloud Provider | [ ] Verified |
| Storage Selection | Storage selection algorithm evaluated for multiple configured datastores | StackConsole Team | [ ] Verified |
| Network Bridges | Linux bridges (vmbr0, etc.) created on all nodes and synchronized into CMP | Cloud Provider | [ ] Verified |
| IPAM Configuration | IP pools, subnets, gateways, and DNS configured under CMP Networks & IPAM | Cloud Provider | [ ] Verified |
| Backup Storage | Local backup datastore or PBS instance connected in Cloud Provider Setup | Cloud Provider | [ ] Verified |
| PBS Permissions | PBS API permissions confirmed if Proxmox Backup Server is utilized | Cloud Provider | [ ] Verified |
| Rate Card Packages | VM packages, volume packages, snapshot pricing, and IP pricing active | Cloud Provider | [ ] Verified |
| End-to-End VM Deploy | Test VM provisioned from customer portal, verified running, and destroyed | Both Teams | [ ] Verified |
| Lifecycle Testing | Start, stop, shutdown, restart, and plan resize executed successfully | Both Teams | [ ] Verified |
| Backup & Restore Test | Test backup created, verified on target storage, and test restore executed | Both Teams | [ ] Verified |
| VM Import Test | Test unmanaged Proxmox VM imported into CMP, verified in billing and portal | Both Teams | [ ] Verified |
5. Proxmox Feature Guides Breakdown
Explore detailed architectural and configuration walkthroughs for specific Proxmox integration topics:
- Connecting CMP to Proxmox: Complete 7-step Cloud Provider wizard, API permissions, credentials, and zone mapping.
- Networks & IPAM Configuration: Linux bridges vs. NICs, network synchronization, IP pools, and Associated IP setup.
- Proxmox Packages: VM packages, volume block storage, snapshots, and unit pricing rate cards.
- Templates Preparation: Building cloud-init enabled, QEMU-agent ready Proxmox templates.
- Node Selection Algorithm: Multi-node placement logic, memory weighting, and CPU load balancing.
- Networks Feature Overview: Customer portal bridge assignments and network boundaries.
- IPAM Feature Overview: CMP-native IP address pool management and allocation.
- Backup Feature Overview: Local and PBS backup destinations, schedules, and recovery.
- Upcoming & Roadmap: Proxmox SDN development, external storage improvements, and future capabilities.