Kubernetes-native private cloud — multi-tenant IaaS on KubeVirt with a CloudStack-like API and UI.
Built for teams leaving Proxmox (or avoiding raw KubeVirt YAML) who already run Kubernetes.
| Layer | Technology |
|---|---|
| Control plane | Go REST API + React UI |
| Source of truth | virtfoundry.io CRDs + operator |
| Hypervisor | KubeVirt |
| Networking | Multus, tenant VPCs, optional MetalLB VIPs |
| Kubernetes as a service | VKS: managed clusters, Kamaji control plane, VM workers |
| Infrastructure as code | Terraform provider |
| GitOps | Helm + Argo CD · CRD store (no MySQL) |
Homelab E2E suite covers VM lifecycle, volumes, snapshots, tenant IAM, and L4 load balancers on the CR store.
| Documentation | https://virtfoundry.github.io/helm-charts/docs/ |
| Prerequisites | https://virtfoundry.github.io/helm-charts/docs/guide/prerequisites/ |
| Quickstart (< 30 min) | https://virtfoundry.github.io/helm-charts/docs/guide/quickstart/ |
| Kubernetes clusters (VKS) | https://virtfoundry.github.io/helm-charts/docs/guide/features/vks/ |
| Terraform provider | https://virtfoundry.github.io/helm-charts/docs/guide/terraform/ |
| Troubleshooting | https://virtfoundry.github.io/helm-charts/docs/guide/troubleshooting/ |
| Why VirtFoundry | https://virtfoundry.github.io/helm-charts/docs/guide/why/ |
| Adopters | https://github.com/virtfoundry/core/blob/main/ADOPTERS.md |
| CNCF readiness | https://github.com/virtfoundry/core/blob/main/docs/CNCF-CHECKLIST.md |
| Discussions | https://github.com/virtfoundry/core/discussions |
Current release: 0.12.0 (pin both charts). Terraform provider: 0.4.1.
helm repo add virtfoundry https://virtfoundry.github.io/helm-charts
helm repo update
helm install virtfoundry-crds virtfoundry/virtfoundry-crds \
--version 0.12.0 \
-n virtfoundry-system --create-namespace
helm install virtfoundry-operator virtfoundry/virtfoundry-operator \
--version 0.12.0 \
-n virtfoundry-system
helm install virtfoundry virtfoundry/virtfoundry \
--version 0.12.0 \
-n virtfoundry-system \
--set secrets.rootPassword='change-me' \
--set secrets.jwtSecret='change-me'Optional, for managed Kubernetes clusters (needs Kamaji; chart is installed from the repo, not the Helm index):
git clone --branch v0.12.0 https://github.com/virtfoundry/vks.git
helm install virtfoundry-vks ./vks/charts/virtfoundry-vks -n virtfoundry-system| Repo | Role |
|---|---|
| core | REST API, UI, kubernetes store client |
| operator | CRDs + controllers (Tenant, Instance, …) |
| vks | VKS operator: VKSCluster to Kamaji control plane + worker Instances |
| vks-image-factory | Node image (node-ubuntu containerDisk) for VKS workers |
| helm-charts | Helm charts + documentation site |
| terraform-provider-virtfoundry | Terraform provider |
| Who | Type |
|---|---|
| Matheus Thurler | Homelab / maintainer |
| Weslei Paulo Pereira | Homelab / maintainer |
| Rodrigo Gonçalves | Homelab / maintainer |
| Name | GitHub | Company | Role |
|---|---|---|---|
| Matheus Thurler | @Matheus-Thurler | CI&T | Lead — DevOps / SRE |
| Weslei Paulo Pereira | @wesleip | CI&T | Maintainer — DevOps / SRE |
| Rodrigo Gonçalves | @RodrigoGoncalves-dev | SYS MANAGER INFORMATICA LTDA | Maintainer — full-stack |
Canonical: MAINTAINERS.md · GOVERNANCE · CONTRIBUTING · SECURITY
Apache 2.0 · CNCF Code of Conduct