Forge Home


Manage /etc/hosts file.


10,488 latest version

4.1 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.0.1 (latest)
released May 16th 2012

Start using this module

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

Add this module to your Puppetfile:

mod 'kupson-hosts', '0.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add kupson-hosts
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install kupson-hosts --version 0.0.1

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.



kupson/hosts — version 0.0.1 May 16th 2012

Manage /etc/hosts file.


This module is suitable mostly for small groups of hosts without private DNS resolver nearby. It updates /etc/hosts file from template and add host entries grouped by environment to it.

Warning: Host entries not managed by Puppet will be erased on install (and template version updete).


  • puppet_ip - Puppet host IP address (extlookup() variable)



Replace /etc/hosts with template file and add all hosts from node $environment to it.

include hosts


Same as hosts class but import all host resources. Suitable for puppet master host or other all-environment nodes.

include hosts::allenv


Only replace /etc/hosts with template file, do not import resources.

include hosts::minimal

hosts::params notes

Parameters for this module such as template version. Change it if you need to trigger /etc/hosts file update on nodes.

Right now $puppet_ip variable is pupulated by call to extlookup() function. Please change it to other data source as needed.