● Beta — KubeEra is in active development. Profiles are live; AI-perception measurement is rolling out.
K

Kubespray

Platform
Open source · Apache-2.0

Kubespray is a collection of Ansible playbooks for deploying production-grade Kubernetes clusters on bare metal, VMs, or existing cloud instances.

updated 2026-07-01

What it is

Kubespray is a collection of Ansible playbooks for deploying production-grade Kubernetes clusters on bare metal, VMs, or existing cloud instances. It's not a cloud-managed control plane like EKS/GKE/AKS — you bring the machines (or provisioning via Terraform/OpenStack/etc.), and Kubespray handles OS-level prep, container runtime, etcd, control plane, networking (CNI), and add-ons. It supports HA control planes, multiple CNI options (Calico, Cilium, Flannel, etc.), and a wide matrix of Linux distros. Everything is driven through Ansible inventory and group_vars, so the actual "product" is Jinja templates and YAML, not a binary or operator.

Who builds it and why

Kubespray is a Kubernetes SIG-adjacent project (part of the kubernetes-sigs GitHub org) maintained by a large, distributed set of contributors — 1,377 at last count — rather than a single vendor. There's no single company monetizing it directly; it exists because the community needed a vendor-neutral, scriptable way to stand up conformant Kubernetes clusters outside of managed cloud offerings, particularly for on-prem, air-gapped, or hybrid environments. CNCF maturity level isn't publicly listed for this project specifically, but its home under kubernetes-sigs gives it de facto legitimacy and alignment with upstream Kubernetes release cycles.

Production readiness signal

18.6K GitHub stars, 1,377 contributors, and a commit as recent as mid-2026 indicate this is actively maintained, not abandoned. Release cadence (currently v2.31.0) tracks closely with upstream Kubernetes minor versions, which is a good sign for staying current with CVEs and deprecations. Apache-2.0 licensing means no legal friction for commercial use. The large contributor count is a double-edged signal: it shows broad community investment, but also means code review consistency and long-term ownership of specific modules (say, a niche CNI integration) can vary. Check the CHANGELOG and open issues for your specific OS/CNI/runtime combo before committing — some combinations get far more testing than others.

Who should use this

  • Teams running Kubernetes on bare metal or in on-prem/private cloud environments where managed K8s isn't an option.
  • Organizations needing air-gapped or highly customized cluster builds (specific kernel versions, custom CNI configs, FIPS compliance, etc.).
  • Platform teams that already have Ansible expertise and want fine-grained control over every component version and flag.
  • Anyone building a repeatable, version-controlled cluster bootstrap process across many environments (dev/staging/prod parity via inventory files).

Who should NOT use this

  • Teams on AWS/GCP/Azure who just need a working cluster — use EKS/GKE/AKS instead. Kubespray adds operational burden managed services eliminate entirely.
  • Small teams without Ansible experience — the learning curve for troubleshooting failed playbook runs on a semi-broken cluster is steep and not well-documented for beginners.
  • Anyone needing day-2 lifecycle management (upgrades, scaling, node repair) baked in — Kubespray handles initial deployment and upgrades reasonably well, but it's not a full cluster-lifecycle operator like Cluster API or Rancher.
  • Teams wanting a "click and go" experience — this is infrastructure-as-code with all the debugging that entails when a playbook fails halfway through a 40-node rollout.

Alternatives

  • kOps – similar bare-metal/cloud-agnostic philosophy but with more opinionated cluster lifecycle management and built-in cloud provider integrations.
  • Rancher (RKE2/K3s) – higher-level platform with a UI, multi-cluster management, and easier day-2 operations, at the cost of more opinionated architecture.
  • Cluster API (CAPI) – Kubernetes-native declarative cluster lifecycle management, better suited for teams wanting GitOps-style cluster provisioning rather than Ansible runs.

Pricing

Fully open source, Apache-2.0 licensed, free to use. No paid tier, no enterprise edition, no vendor behind it selling support contracts. If you need commercial support, you're looking at third-party consultancies or in-house Kubernetes/Ansible expertise — there's no official paid support channel tied to the project itself.

Frequently asked

What is Kubespray?+
Kubespray is a collection of Ansible playbooks for deploying production-grade Kubernetes clusters on bare metal, VMs, or existing cloud instances. It's not a cloud-managed control plane like EKS/GKE/AKS — you bring the machines (or provisioning via Terraform/OpenStack/etc.
Who builds Kubespray?+
Kubespray is a Kubernetes SIG-adjacent project (part of the kubernetes-sigs GitHub org) maintained by a large, distributed set of contributors — 1,377 at last count — rather than a single vendor.
Is Kubespray production ready?+
18.6K GitHub stars, 1,377 contributors, and a commit as recent as mid-2026 indicate this is actively maintained, not abandoned. Release cadence (currently v2.31.0) tracks closely with upstream Kubernetes minor versions, which is a good sign for staying current with CVEs and deprecations. Apache-2.
Who should use Kubespray?+
Teams running Kubernetes on bare metal or in on-prem/private cloud environments where managed K8s isn't an option. Organizations needing air-gapped or highly customized cluster builds (specific kernel versions, custom CNI configs, FIPS compliance, etc.).
Who should not use Kubespray?+
Teams on AWS/GCP/Azure who just need a working cluster — use EKS/GKE/AKS instead. Kubespray adds operational burden managed services eliminate entirely.
What are the alternatives to Kubespray?+
kOps – similar bare-metal/cloud-agnostic philosophy but with more opinionated cluster lifecycle management and built-in cloud provider integrations. Rancher (RKE2/K3s) – higher-level platform with a UI, multi-cluster management, and easier day-2 operations, at the cost of more opinionated architecture.
How much does Kubespray cost?+
Fully open source, Apache-2.0 licensed, free to use. No paid tier, no enterprise edition, no vendor behind it selling support contracts.