Config Files: hiera.yaml

This version is out of date. For current versions, see Puppet packages and versions.

The hiera.yaml file is used to configure Hiera, which Puppet can use to look up data.


The hiera.yaml file is located at $confdir/hiera.yaml by default. Its location is configurable with the hiera_config setting.

When Puppet loads Hiera, it will use its own Hiera config file instead of the global one (which is usually located at /etc/hiera.yaml). If needed, you can point the hiera_config setting at the global Hiera config.

The location of the confdir varies; it depends on the OS, Puppet distribution, and user account. See the confdir documentation for details.


  - yaml
  - json
  :datadir: /etc/puppet/hieradata
  :datadir: /etc/puppet/hieradata
  - "%{clientcert}"
  - "%{datacenter}"
  - "%{osfamily}"
  - common


See the Hiera documentation for full details about the hiera.yaml file.

See an issue? Please file a JIRA ticket in our [DOCUMENTATION] project
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.