DETalk to us →
ClusterPilot Docs
v0.0.1 RC · fcc5871
Start with:EvaluateInstallCreate a clusterOperateRecoverAutomate
Documentation/Reference
Reference · v0.0.1

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 sourcefcc5871 · 30 July 2026
RC

Exact release scope. This page documents the reviewed v0.0.1 source at fcc5871. Check release status before enabling a gated capability.

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; chart-managed PostgreSQL is unsupported
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
TrustPublic CA TLS · private CA TLS · approved mTLS/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

CapabilityMaturityDefault
Hetzner CloudStable · production-gatedEnabled / supported
IONOS CloudStable · production-gatedEnabled / supported
AWS and AzureDisabled in v0.0.1Disabled
Cluster infrastructure and lifecycleProduction-gatedEnabled on clean installs
Kubernetes read operationsPreviewEnabled
Sensitive Kubernetes mutationsContract-onlyDisabled
Built-in/custom add-on installPreviewEnabled
Add-on upgrade/uninstallContract stubDisabled
Self-hosted distributionProduction-gatedRelease approval required

Catalog and validation tools

AreaBaseline
ConformanceSonobuoy v0.57.5; candidate catalog; 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