VirtFoundry Helm Charts

Official Helm charts for VirtFoundry — private cloud IaaS on Kubernetes.

Documentation (canonical front door): virtfoundry.github.io/helm-charts/docs/

Quick install

Install order: KubeVirt + Multus + CDI on the cluster → virtfoundry-crds → virtfoundry-operator → virtfoundry (API + UI).

Prerequisite	Required
KubeVirt	Yes — VMs, console, VM snapshots
Multus CNI	Yes — VPCs, tenant networks, public IPs
CDI	Yes for ISO/import; optional for container-disk templates
StorageClass	Yes for disks
Ingress or Gateway API	One of them — expose UI/API

Laptop (kind, no VLAN): Kind guide installs the platform stack. Full details: installation guide.

helm repo add virtfoundry https://virtfoundry.github.io/helm-charts
helm repo update

# After KubeVirt, Multus, CDI
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 --create-namespace \
  --set secrets.rootPassword='choose-a-strong-password' \
  --set secrets.jwtSecret="$(openssl rand -hex 32)"

The chart ships no credential defaults: install fails until secrets.rootPassword (min 12 chars) and secrets.jwtSecret (min 32 chars) are set, or secrets.existingSecret points at a Secret you manage. See Secrets.

Local validation

export KUBECONFIG=/path/to/kubeconfig
make lint

Repository layout

charts/virtfoundry/           # Control plane (API, UI)
charts/virtfoundry-crds/      # virtfoundry.io CRDs
charts/virtfoundry-operator/  # operator
charts/virtfoundry-platform/  # operator + core + optional VKS in one release
docs/                         # MkDocs site (GitHub Pages)
scripts/                      # Optional setup and sideload helpers

Related

Repository	Role
virtfoundry/core	Application source
virtfoundry/operator	CRDs and Kubernetes operator
Why VirtFoundry	Positioning (Proxmox / KubeVirt)
CNCF checklist	CNCF / community phases

Contributing

See CONTRIBUTING.md. GOVERNANCE.md · MAINTAINERS.md · SECURITY.md · CODE_OF_CONDUCT.md

License

Apache License 2.0 — see LICENSE and NOTICE.