Version: main 🚧

Node Requirements

Limited vCluster Tenancy Configuration Support

This feature is only available for the following:

Running the control plane as a binary for vCluster Standalone, which uses private nodes.

Control plane node requirements

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

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.)

warning

Security-Enhanced Linux (SELinux) is currently not supported.

Log into each node and manually increase the watchers limit.

Log into the Node. Use SSH or your preferred method for node access.
Confirm the current inotify watchers limit by running:
```
cat /proc/sys/fs/inotify/max_user_watches
```
Increase the limit temporarily.
```
sudo sysctl fs.inotify.max_user_watches=524288
```
Adjust the value as needed; 524288 is typically sufficient.
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
```

OS	Version	Additional Instructions
Ubuntu	24.04
Ubuntu	22.04
RHEL (RedHat Enterprise Linux)	10	Disable SElinux
RHEL (RedHat Enterprise Linux)	9	Disable SElinux
CentOS Stream	9	Disable SElinux and install `iptables`

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