Self-hosted
DERequest a demo →
Skip to documentation content
ClusterPilot Docs
Product tour Self-hosted
Start with:EvaluateInstallCreate a clusterOperateRecoverAutomate
Documentation/Reference
Reference

Support matrix

Use the exact release compatibility manifest as the final authority for versions and combinations.

AudienceEvaluators, release engineers, supportReading time12 minCommands in contextNo terminal requiredReviewed source9552586 · 1 August 2026

Control-plane deployment

SurfaceSupported baseline
Profilesprofile-single-node · profile-split · profile-ha-ready
Install surfacesRelease-owned Linux/Compose entrypoint · official ClusterPilot Helm chart
DatabaseExternal durable PostgreSQL
ArtifactsDurable filesystem or S3-compatible; multi-replica filesystem must be shared
SecretsBase64 32-byte master key, managed key ID, Secret/file references; no insecure fallback
ImagesDigest-pinned clusterpilot-api and clusterpilot-agent release subjects
HA safetyLeader election plus durable shared dependencies when API or worker replicas exceed one

Agent host baseline

DimensionSupported baseline
Operating systemsUbuntu 22.04+ · Debian 12+ · RHEL/Rocky/AlmaLinux 9+
RuntimeContainer-first Compose; optional systemd wrapper
Version policyN and N-1 accepted; N-2 rejected
Trust and authorizationPublic/private CA server trust · bootstrap token enrollment · run-scoped expiring tokens · approved loopback placement
Shutdown5–600 seconds, default 300; container stop grace must be greater

Cluster baseline

KubernetesHelmCalico
1.32.13v3.20.2v3.31.5
1.33.13v3.21.1v3.31.5
1.34.9v3.21.1v3.32.0
1.35.6v3.21.1v3.32.0
1.36.2v3.21.1v3.32.0
Node dimensionSupported baseline
Operating systemsUbuntu 22.04/24.04 · Debian 11/12 · RHEL 8/9 · Rocky 8/9 · AlmaLinux 8/9 · CentOS Stream 9
Kernel5.4 or newer
UpgradeOne Kubernetes minor per operation
Ingress endpointsingle-cp01 (non-HA) · managed-ha-vip (at least 3 control-plane nodes, L2 VRRP)

Providers and operational features

CapabilityStatusWhat it provides
Hetzner CloudAvailableProvider and infrastructure workflow
IONOS CloudAvailableVDC, LAN, network and infrastructure workflow
Cluster infrastructure and lifecycleAvailableCreate, scale, update, repair and delete
Kubernetes operationsAvailableInventory, status, logs and diagnostics
Built-in and custom add-onsAvailablePlan, install and verify platform services
Independent Kubernetes ValidationAvailableRun checks and keep reports with the cluster
Self-hosted distributionSelf-hostedCompose, Helm and private registry workflows

Catalog and validation tools

AreaBaseline
ConformanceCatalog 0.0.3 · supported · Sonobuoy v0.57.5 · Kubernetes v1.36.2 · quick, non-disruptive and certified modes
Delivery/certificatesArgo CD 2.13.1 · Flux 2.4.0 · cert-manager 1.16.2
PolicyGatekeeper 3.17.1 · Kyverno 1.12.6
Ingressingress-nginx 1.11.3 · Traefik 3.2.1 (managed conflict)
ObservabilityPrometheus 2.55.1 · Grafana 11.3.1 · Loki 3.2.1 · OpenSearch 2.17.1
Registry/storage/recoveryHarbor 2.12.2 · Rook Ceph 1.15.7 · Velero 1.15.0

Compatibility authority