Configure CoreDNS Server




2,594 latest version

5.0 quality score

Version information

  • 0.1.3 (latest)
  • 0.1.2
  • 0.1.1
released Jul 16th 2019
This version is compatible with:
  • Puppet Enterprise 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, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 7.0.0
  • CentOS

Start using this module


othalla/coredns — version 0.1.3 Jul 16th 2019


Table of Contents

  1. Description
  2. Usage - Configuration options and additional functionality
  3. Limitations - OS compatibility, etc.
  4. Development - Guide for contributing to the module


Puppet module to install CoreDNS Server.


Install CoreDNS & systemd unit without any zone and default parameters:

include coredns

Create a DNS zone . that match all request, with prometheus, logs and error plugin that forward all request to google public DNS

coredns::zone { '.':
  prometheus                => true,
  prometheus_listen_address => $facts['ipaddress'],
  prometheus_listen_port    => 9153,
  log                       => true,
  errors                    => true,
  forward                   => true,
  forward_to                => [''],

Create a DNS zone that match all requests to example.local using auto plugin which read zones from /etc/coredns/zones directory:

coredns::zone { 'example.local':
  log         => true,
  errors      => true,
  auto        => 'example.local',
  auto_config => {
    'directory' => '/etc/coredns/zones',


This section is deprecated. Instead, add reference information to your code as Puppet Strings comments, and then use Strings to generate a in your module. For details on how to add code comments and generate documentation with Strings, see the Puppet Strings documentation and style guide

If you aren't ready to use Strings yet, manually create a in the root of your module directory and list out each of your module's classes, defined types, facts, functions, Puppet tasks, task plans, and resource types and providers, along with the parameters for each.

For each element (class, defined type, function, and so on), list:

  • The data type, if applicable.
  • A description of what the element does.
  • Valid values, if the data type doesn't make it obvious.
  • Default value, if any.

For example:

### `pet::cat`

#### Parameters

##### `meow`

Enables vocalization in your cat. Valid options: 'string'.

Default: 'medium-loud'.


This module only configure coredns installation, service, and Corefile configuration. It does not configure DNS zone entries & records.


This module is actually being developped. New features may come soon! Feel free to contriute!