Forge Home


Manage /etc/hosts file.


10,300 latest version

4.1 quality score

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.