Kubernetes Cluster API Provider for Proxmox Virtual Environment - CAPMOX
June 29, 2026 · View on GitHub
Overview
The Cluster API brings declarative, Kubernetes-style APIs to cluster creation, configuration and management. Cluster API Provider for Proxmox VE is a concrete implementation of Cluster API for Proxmox VE.
Launching a Kubernetes cluster on Proxmox VE
Check out the quickstart guide for launching a cluster on Proxmox VE.
Compatibility with Cluster API and Kubernetes Versions
This provider's versions are compatible with the following versions of Cluster API:
CAPMOX v1alpha2 (current)
Cluster API v1beta2
| CAPI v1.11 | CAPI v1.12 | |
|---|---|---|
| CAPMOX v0.8 | ✓ | |
| CAPMOX v0.9 | ✓ | ✓ |
CAPMOX v1alpha1 (obsolete)
Cluster API v1beta1
| CAPI v1.4 | CAPI v1.5 | CAPI v1.6 | CAPI v1.7 | CAPI v1.8 | CAPI v1.9 | CAPI v1.10 | |
|---|---|---|---|---|---|---|---|
| CAPMOX v0.1 | ✓ | ✓ | ☓ | ☓ | ☓ | ☓ | ☓ |
| CAPMOX v0.2 | ☓ | ✓ | ✓ | ☓ | ☓ | ☓ | ☓ |
| CAPMOX v0.3 | ☓ | ✓ | ✓ | ✓ | ☓ | ☓ | ☓ |
| CAPMOX v0.4 | ☓ | ✓ | ✓ | ✓ | ☓ | ☓ | ☓ |
| CAPMOX v0.5 | ☓ | ☓ | ✓ | ✓ | ☓ | ☓ | ☓ |
| CAPMOX v0.6 | ☓ | ☓ | ☓ | ✓ | ✓ | ☓ | ☓ |
| CAPMOX v0.7 | ☓ | ☓ | ☓ | ☓ | ✓ | ✓ | ✓ |
(See Kubernetes support matrix of Cluster API versions).
Documentation
Further documentation is available in the /docs directory.
Community, discussion, contribution, and support
Learn how to engage with the Kubernetes community on the community page.
You can reach the maintainers of this project on the Slack channel.
See what the community is doing with CAPMOX on the In the media page.
Security
We take security seriously. Please read our security policy for information on how to report security issues.