gantsign.inotify

Ansible Role: Inotify

This role helps configure the settings for the Inotify system.

Usually, the default setting of max_user_watches is too low for desktop users, especially when using Integrated Development Environments (IDEs).

Requirements

Ansible version 2.9 or higher
- Note: Older versions might work but haven't been tested.
Compatible Linux Distributions
- Debian Family
  - Debian
    - Stretch (9)
    - Buster (10)
    - Bullseye (11)
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- RedHat Family
  - Rocky Linux
    - 8
- Note: Other versions might work but haven't been tested.

Role Variables

These variables change how the role works (default values are shown below):

# Maximum number of events allowed to be queued for an inotify instance.
inotify_max_queued_events:

# Maximum number of inotify instances that can be created for each user.
inotify_max_user_instances:

# Maximum number of watches that can be created for each user.
inotify_max_user_watches:

# Filename to save the inotify configuration.
inotify_sysctl_file: '/etc/sysctl.d/20-ansible-inotify.conf'

Example Playbook

- hosts: servers
  roles:
    - role: gantsign.inotify
      inotify_max_user_watches: 524288

More Roles From GantSign

You can find more roles by GantSign on Ansible Galaxy.

Development & Testing

This project uses Molecule for development and testing. The role is unit tested using Testinfra and pytest.

To develop or test, you should have the following installed:

Linux (e.g. Ubuntu)
Docker
Python (also python-pip)
Ansible
Molecule

Since installing the above can be complicated, this project includes Molecule Wrapper, which is a script that installs Molecule and its dependencies (except for Linux) and then runs Molecule with the command you provide.

To test this role using Molecule Wrapper, run the following command from the project root: