Skip to main content
Version: main 🚧

Node Requirements

Supported Configurations
Running the control plane as a binary with vCluster Standalone. When scaling with additional worker nodes, they are joined as private nodes.

Control plane node requirements​

  • Network connectivity between any control plane and worker nodes being used for the cluster

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
  • Increased inotify watchers on each node. fs.inotify resource limits (defined by fs.inotify.max_user_watches and fs.inotify.max_user_instances system variables. For example, in Ubuntu these default to 8192 and 128 respectively, which is not enough.)
info

On RHEL 8 and 9, SELinux in enforcing mode is supported with the vcluster-selinux RPM. install-standalone.sh installs it automatically; no extra steps are required. See SELinux support.

Increase the inotify watchers limit​

Log into each node and manually increase the watchers limit.

  1. Log into the Node. Use SSH or your preferred method for node access.

  2. Confirm the current inotify watchers limit by running:

    cat /proc/sys/fs/inotify/max_user_watches

  3. Increase the limit temporarily.

    sudo sysctl fs.inotify.max_user_watches=524288

    Adjust the value as needed; 524288 is typically sufficient.

  4. Increase the limit permanently.

    To make the change persistent across reboots, add it to the sysctl configuration:

    echo "fs.inotify.max_user_watches=524288" | sudo tee -a /etc/sysctl.conf
    sudo sysctl -p

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