How to resolve inotify watcher limits (fs.inotify.max_user_instances) during installation?
What causes this issue? Copied
During the ITRS Analytics setup or preflight check, you might see this message if the system’s limits on file watchers are too low. This error failed to create fsnotify watcher: too many open files
occurs when the system cannot create an inotify
watcher, which is a mechanism used by Linux to monitor file system events.
The problem is typically caused by the Linux kernel parameter fs.inotify.max_user_instances
. This setting defines the maximum number of inotify
instances a single user can create.
By default, most Linux distributions set this value to 128
, which is not enough for ITRS Analytics extensive file monitoring requirements. As a result, KOTS fails to create the necessary watchers.
How can I fix this? Copied
You can resolve the issue by increasing the fs.inotify.max_user_instances
value.
For example, increase it from 128
to 1000
.
This allows KOTS to successfully create the required inotify
watchers and continue with the setup process.