Forge Home


Install and manage arpwatch


603 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.3.0 (latest)
  • 0.2.1
  • 0.2.0
  • 0.1.2
  • 0.1.1
  • 0.1.0 (deleted)
released Mar 1st 2022
This version is compatible with:
  • Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 8.0.0
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'ardichoke-arpwatch', '0.3.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add ardichoke-arpwatch
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install ardichoke-arpwatch --version 0.3.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



ardichoke/arpwatch — version 0.3.0 Mar 1st 2022


Table of Contents

  1. Description
  2. Setup - The basics of getting started with arpwatch
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. Release Notes


Install and configure arpwatch


Beginning with arpwatch

include ::arpwatch is enough to get you up and running.


All interaction with the arpwatch module is done through the main arpwatch class. You can simply set the options in ::arpwatch to have full functionality of the module.



Public Classes

  • arpwatch: Main class, installs and configures arpwatch

Private Classes

  • arpwatch::params: Determines and sets the defaults used by the main arpwatch class


The following parameters are available in the ::arpwatch class:


Specifies a file for arpwatch's configuration. Valid options: string containing an absolute path. Default value: '/etc/sysconfig/arpwatch'


Specifies a file to act as a ERB template for the config file. Valid options: string containing a path (absolute, or relative to the module path). Example value: 'arpwatch/conf.rhel.erb'


Specifies the email address to send arpwatch alerts to. Valid options: string. Default value: '-' (suppresses all email output from arpwatch)


Specifies the interface to monitor for arp changes. Valid options: string containing an interface name. Default: eth0


Specify additional options to pass to arpwatch at start. Valid options: string of command line options. Default: OS dependant


Tells Puppet whether the arpwatch package should be installed, and what version. Valid options: 'present', 'latest', or a specific version number. Default value: 'present'


Tells Puppet what arpwatch package to manage. Valid options: string. Default value: 'arpwatch'


Tells Puppet whether to enable the arpwatch service at boot. Valid options: true or false. Default value: true


Tells Puppet whether the arpwatch service should be running. Valid options: 'running' or 'stopped'. Default value: 'running'


Tells Puppet what arpwatch service to manage. Valid options: string. Default value: 'arpwatch'


Specifies which user account arpwatch should run under. Valid options: string. Default value: 'arpwatch' ('pcap' under RHEL5)


Specifies the source email address for arpwatch emails. Only works under RedHat family distributions. Valid options: string. Default value: 'arpwatch@${::fqdn}'


This module currently supports RedHat and Debian distributions. It has only been thoroughly tested under RedHat. Pull requests are welcome to add support for other platforms.


Pull requests are welcome. Please make sure to properly document any additions or changes made to the module.

Release Notes

v0.2.0 - Add support for Debian

v0.1.2 - Add spec tests and dependencies

v0.1.0 - Initial release of arpwatch module