v0.7.3 · CRD store

VirtFoundry¶

Kubernetes-native private cloud control plane — multi-tenant VMs on KubeVirt, Multus networking, and a CloudStack-like API/UI. Platform state lives in virtfoundry.io CRDs (no MySQL in production). Built for people leaving Proxmox who already run Kubernetes.

Quickstart Why VirtFoundry Adopters Installation GitHub

Control plane¶

Go API over virtfoundry.io CRDs (via operator); REST /api/v1 for UI, Terraform, and GitOps.

KubeVirt VMs¶

Deploy, start, stop, snapshot, and console into VirtualMachines from the UI or API.

Multus networking¶

VPCs, isolated L2 networks, public IP pools, and default VPC per tenant.

IAM & isolation¶

JWT login, API keys, roles, tenant namespaces, and Kubernetes NetworkPolicy.

UI¶

Sign-in

Quick install¶

Install order: platform on the cluster → virtfoundry-operator → virtfoundry (API + UI).

Prerequisite	Required	Role
KubeVirt	Yes	Hypervisor — VMs, console, VM snapshots
Multus CNI	Yes	Tenant VPCs, isolated L2, public VM network
CDI	Yes for ISO/import templates	`DataVolume` imports; optional for container-disk-only
StorageClass	Yes for disks	PVCs for VM volumes (Longhorn recommended)
Ingress or Gateway API	One of them	Hostname for UI + API
virtfoundry-operator chart	Yes	`virtfoundry.io` CRDs + controller
virtfoundry chart	Yes	Control plane (API + UI only)

KubeVirt, Multus, and CDI are not bundled — install them separately (or use Kind on a laptop). Details: Installation → Prerequisites.

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

# 1. CRDs + operator (after KubeVirt, Multus, CDI)
helm install virtfoundry-operator virtfoundry/virtfoundry-operator \
  --version 0.7.3 \
  --namespace virtfoundry-system --create-namespace

# 2. API + UI
helm install virtfoundry virtfoundry/virtfoundry \
  --version 0.7.3 \
  --namespace virtfoundry-system \
  --set secrets.rootPassword='choose-a-strong-password' \
  --set secrets.jwtSecret="$(openssl rand -hex 32)"

Gateway API or Ingress profiles are configured via Helm values — see Configuration. Under-30-minute walkthrough: Quickstart.

Architecture¶

Layer	Technology
Control plane	Go API + virtfoundry-operator (`virtfoundry.io` CRDs)
Persistence	Kubernetes CRDs (+ Secrets for credential hashes)
Hypervisor	KubeVirt VirtualMachine
Networking	Multus NADs, host bridges, optional MetalLB
Security	IAM, JWT, API keys, tenant namespaces, NetworkPolicy
UI	React + Vite + Redux + TanStack Query
Packaging	Helm chart (`helm-charts`)

Repositories¶

Repository	Role
core	Application source (API, UI, kubernetes store)
operator	CRDs and Kubernetes operator
helm-charts	Helm charts, deploy scripts, this documentation
terraform-provider-virtfoundry	Terraform provider

Adopters & CNCF¶

Homelab adopters: Matheus Thurler, Weslei Paulo Pereira, Rodrigo Gonçalves (full list).

CNCF Sandbox readiness tracker: CNCF-CHECKLIST.md in core.

Quickstart Kind (laptop) Why VirtFoundry Installation guide Website / front door Helm repository Versioning policy Contributing GitHub Issues