Skip to main content
Version: main 🚧

Node Requirements

Supported Configurations
Running the control plane as a container with:

Private node requirements​

  • vCluster CLI installed on your local machine
  • Access to a control plane cluster
  • Worker nodes
  • kubeadm is used in the join script, so meeting the kubeadm requirements is recommended

Host requirements​

  • Linux distribution with SystemD support (required for service management)
  • iptables binaries installed (automatically available on Ubuntu, may need manual installation on other distributions)
  • curl installed
  • Root user access
info

On RHEL 8 and 9, SELinux in enforcing mode is supported with the vcluster-selinux RPM. The Private Node join script installs it automatically; no extra steps are required. See SELinux support.

Supported operating systems​

OSVersionAdditional Instructions
Ubuntu24.04
Ubuntu22.04
RHEL (RedHat Enterprise Linux)9Install vcluster-selinux or disable SELinux
RHEL (RedHat Enterprise Linux)8Install vcluster-selinux and pin Kubernetes to 1.31, or disable SELinux
RHEL (RedHat Enterprise Linux)10Disable SELinux
CentOS Stream9Disable SELinux and install iptables
Rocky10Disable SELinux and install iptables
Rocky9Disable SELinux and install iptables

CentOS Stream and Rocky support​

Install iptables
yum install iptables-services
systemctl enable iptables
systemctl start iptables