< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

Environment Requirements

This page summarizes the some requirements for installing and using KubeSphere.

System Requirements

System Minimum Requirements (Each node)
Ubuntu 16.04, 18.04 CPU: 2 Cores, Memory: 4 GB, Disk Space: 40 GB
Debian Buster, Stretch CPU: 2 Cores, Memory: 4 GB, Disk Space: 40 GB
CentOS 7.x CPU: 2 Cores, Memory: 4 GB, Disk Space: 40 GB
Red Hat Enterprise Linux 7 CPU: 2 Cores, Memory: 4 GB, Disk Space: 40 GB
SUSE Linux Enterprise Server 15 /openSUSE Leap 15.2 CPU: 2 Cores, Memory: 4 GB, Disk Space: 40 GB

Dependency Requirements

Dependency Kubernetes Version ≥ 1.18 Kubernetes Version < 1.18
socat Required Optional but recommended
conntrack Required Optional but recommended
ebtables Optional but recommended Optional but recommended
ipset Optional but recommended Optional but recommended

Container Runtime Requirements

Supported Container Runtime Version
Docker 19.3.8+
containerd Latest
CRI-O (experimental, not fully tested) Latest
iSula (experimental, not fully tested) Latest

Network Requirements

  • Make sure the DNS address in /etc/resolv.conf is available. Otherwise, it may cause some issues of DNS in the cluster.
  • If your network configuration uses firewall rules or security groups, you must ensure infrastructure components can communicate with each other through specific ports. It is recommended that you turn off the firewall. For more information, see Port Requirements.
  • Supported CNI plugins: Calico and Flannel. Others (such as Cilium and Kube-OVN) may also work but note that they have not been fully tested.

Supported Kubernetes Versions

Installation Tool KubeSphere version Supported Kubernetes versions
KubeKey 3.3.2 v1.20.x, v1.21.x, * v1.22.x, * v1.23.x, * v1.24.x
ks-installer 3.3.2 v1.20.x, v1.21.x, * v1.22.x, * v1.23.x, * v1.24.x

Note

For Kubernetes versions with an asterisk, some features of edge nodes may be unavailable due to incompatability. Therefore, if you want to use edge nodes, you are advised to install Kubernetes v1.21.x.

Supported CSI Plugins

Kubernetes has announced that in-tree volume plugins will be removed from Kubernetes in version 1.21. For more information, see Kubernetes In-Tree to CSI Volume Migration Moves to Beta. Therefore, it is recommended that you install CSI plugins instead.

Supported CSI plugins:

Supported Web Browsers for Accessing the Console

console-browser

Receive the latest news, articles and updates from KubeSphere


Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.