kubesphere/kubekey

Install Kubernetes, and related cloud-native add-ons, it supports all-in-one, multi-node, and HA 🔥 ⎈ 🐳

Go

2,867

2,720 commits

updated Oct 16, 2026

See the code

README

CI

English | 中文

👋 Welcome to KubeKey!

KubeKey is an open-source lightweight task flow execution tool. It provides a flexible and fast way to install Kubernetes.

KubeKey has passed the CNCF Kubernetes Conformance Certification

Comparison of new features in 3.x

  1. Expanded from Kubernetes lifecycle management tool to task execution tool (flow design refers to Ansible)
  2. Supports multiple ways to manage task templates: git, local, etc.
  3. Supports multiple node connection methods, including: local, ssh, kubernetes, prometheus.
  4. Supports cloud-native automated batch task management
  5. Advanced features: UI page (not yet open)

Get KubeKey

Method 1: Release Page

Get the corresponding binary files from the Release page.

Method 2: Run Script

curl -sfL https://get-kk.kubesphere.io | sh -
Original FileExtracted File
kubekey-v4.x.x-linux-amd64.tar.gzkk: KubeKey binary
web-installer.tgzdist: Web UI resources.
host-check.yaml, kubernetes, kubesphere: Task template files.
schema: Configuration files.
README.md: Installation documentation.
package.shOffline package build script.

Quick Start

Method 1: Command Line

./kk create cluster

Method 2: Web UI

UI only supported after v4.0.0

./kk web --schema-path web-installer/schema --ui-path web-installer/dist

Documentation Navigation

hacktoberfest
installer
k8s
kubeadm
kubernetes
kubernetes-cluster
kubernetes-deployment

kubesphere/kubekey

Install Kubernetes, and related cloud-native add-ons, it supports all-in-one, multi-node, and HA 🔥 ⎈ 🐳

Go

2,867

2,720 commits

updated Oct 16, 2026

See the code

README

CI

English | 中文

👋 Welcome to KubeKey!

KubeKey is an open-source lightweight task flow execution tool. It provides a flexible and fast way to install Kubernetes.

KubeKey has passed the CNCF Kubernetes Conformance Certification

Comparison of new features in 3.x

  1. Expanded from Kubernetes lifecycle management tool to task execution tool (flow design refers to Ansible)
  2. Supports multiple ways to manage task templates: git, local, etc.
  3. Supports multiple node connection methods, including: local, ssh, kubernetes, prometheus.
  4. Supports cloud-native automated batch task management
  5. Advanced features: UI page (not yet open)

Get KubeKey

Method 1: Release Page

Get the corresponding binary files from the Release page.

Method 2: Run Script

curl -sfL https://get-kk.kubesphere.io | sh -
Original FileExtracted File
kubekey-v4.x.x-linux-amd64.tar.gzkk: KubeKey binary
web-installer.tgzdist: Web UI resources.
host-check.yaml, kubernetes, kubesphere: Task template files.
schema: Configuration files.
README.md: Installation documentation.
package.shOffline package build script.

Quick Start

Method 1: Command Line

./kk create cluster

Method 2: Web UI

UI only supported after v4.0.0

./kk web --schema-path web-installer/schema --ui-path web-installer/dist

Documentation Navigation

hacktoberfest
installer
k8s
kubeadm
kubernetes
kubernetes-cluster
kubernetes-deployment

Project health

Overall

5.2/10

Maintained

10/10

Code review

9/10
OpenSSF Scorecard

Latest release

v3.1.12 · Jan 8, 2026

Releases this year

1

Significant stargazers

Shida Qiu

244 followers · starred Jan 2021

Xinzhao Xu

1,060 followers · starred Jun 2022

Bing Hongtao

43 followers · starred Mar 2022

Weipeng Hong

112 followers · starred Sep 2024