Resource Type: postfix_main

Defined in:


Manages Postfix settings.

The resource name can be used as a shortcut for specifying the setting parameter.


  • ensure (defaults to: present)

    The basic property that the resource should be in.

    Supported values:
    • present
    • absent
  • value

    Value to change the setting to.

    If this value is refers to other settings and those settings are also managed by Puppet, they will be autorequired. If the value can be fully expanded and matches a file resource that exists in the catalogue then it will be autorequired. Lookup tables of the form `type:/path/to/file` will use the filename that is produced by the `postmap(1)` command. For example, a value of `hash:/etc/aliases` will attempt to autorequire `/etc/aliases.db`. Any setting that references a service defined in `` will attempt to autorequire it. This includes the various `$transport_delivery_slot_cost`, etc. settings.


  • name

    The name of the setting or a unique string.

  • provider

    The specific backend to use for this `postfix_main` resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.

  • setting (namevar)

    The name of the setting.

  • target

    The file in which to store the settings, defaults to `/etc/postfix/`.

    If a file resource exists in the catalogue for this value it will be autorequired.