https://github.com/ionos-cloud/cluster-api-provider-proxmox
Cluster API Provider for Proxmox VE (CAPMOX)
https://github.com/ionos-cloud/cluster-api-provider-proxmox
cluster-api kubernetes proxmox
Last synced: 8 months ago
JSON representation
Cluster API Provider for Proxmox VE (CAPMOX)
- Host: GitHub
- URL: https://github.com/ionos-cloud/cluster-api-provider-proxmox
- Owner: ionos-cloud
- License: apache-2.0
- Created: 2023-11-29T13:12:48.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-05T14:15:55.000Z (8 months ago)
- Last Synced: 2025-05-05T15:35:09.682Z (8 months ago)
- Topics: cluster-api, kubernetes, proxmox
- Language: Go
- Homepage:
- Size: 3.86 MB
- Stars: 278
- Watchers: 5
- Forks: 40
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-repositories - ionos-cloud/cluster-api-provider-proxmox - Cluster API Provider for Proxmox VE (CAPMOX) (Go)
- awesome-proxmox-ve - ☸️ Cluster API Provider - style APIs for clusters | (🛠️ Tools & Utilities / 🏗️ Infrastructure as Code)
README
# Kubernetes Cluster API Provider for Proxmox Virtual Environment - CAPMOX
[](https://sonarcloud.io/summary/new_code?id=ionos-cloud_cluster-api-provider-proxmox)
[](https://goreportcard.com/report/github.com/ionos-cloud/cluster-api-provider-proxmox)
[](https://github.com/ionos-cloud/cluster-api-provider-proxmox/actions/workflows/e2e.yml?query=branch%3Amain)
## Overview
The [Cluster API](https://github.com/kubernetes-sigs/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](./docs/Usage.md#quick-start) 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:
| | Cluster API v1beta1 (v1.4) | Cluster API v1beta1 (v1.5) | Cluster API v1beta1 (v1.6) | Cluster API v1beta1 (v1.7) | Cluster API v1beta1 (v1.8) | Cluster API v1beta1 (v1.9) |
|------------------------|:--------------------------:|:--------------------------:|:--------------------------:|:--------------------------:|:--------------------------:|:--------------------------:|
| CAPMOX v1alpha1 (v0.1) | ✓ | ✓ | ☓ | ☓ | ☓ | ☓ |
| CAPMOX v1alpha1 (v0.2) | ☓ | ✓ | ✓ | ☓ | ☓ | ☓ |
| CAPMOX v1alpha1 (v0.3) | ☓ | ✓ | ✓ | ✓ | ☓ | ☓ |
| CAPMOX v1alpha1 (v0.4) | ☓ | ✓ | ✓ | ✓ | ☓ | ☓ |
| CAPMOX v1alpha1 (v0.5) | ☓ | ☓ | ✓ | ✓ | ☓ | ☓ |
| CAPMOX v1alpha1 (v0.6) | ☓ | ☓ | ☓ | ✓ | ✓ | ☓ |
| CAPMOX v1alpha1 (v0.7) | ☓ | ☓ | ☓ | ☓ | ✓ | ✓ |
(See [Kubernetes support matrix](https://cluster-api.sigs.k8s.io/reference/versions.html) 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](http://kubernetes.io/community/).
You can reach the maintainers of this project at:
- [Slack channel](https://kubernetes.slack.com/messages/cluster-api-proxmox)
## Security
We take security seriously.
Please read our [security policy](SECURITY.md) for information on how to report security issues.