Forge Home


A module to configure postfixadmin


677 latest version

5.0 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

  • 1.3.0 (latest)
  • 1.2.8
  • 1.2.7
  • 1.2.6
  • 1.2.5
  • 1.2.4
  • 1.2.3
  • 1.2.2
  • 1.2.1
  • 1.2.0
  • 1.1.1
  • 1.1.0
  • 1.0.2
  • 1.0.1
  • 1.0.0
released Feb 27th 2022
This version is compatible with:
  • Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 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.0.0 < 8.0.0
  • , Ubuntu

Start using this module

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

Add this module to your Puppetfile:

mod 'cirrax-postfixadmin', '1.3.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add cirrax-postfixadmin
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install cirrax-postfixadmin --version 1.3.0

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.



cirrax/postfixadmin — version 1.3.0 Feb 27th 2022

postfixadmin puppet module

Build Status Puppet Forge Puppet Forge Puppet Forge Puppet Forge

Table of Contents

  1. Overview
  2. Usage - Configuration options and additional functionality


This module is used to configure postfixadmin.

It assumes, you are using hiera to configure.


Just include the postfixadmin class and add some hiera definitions....

Details about the configuration possibilities are documented in the classes or in the REFERENCE file.

Remark for Debian bullseye (11)

Debian bullseye (11) does not ship a package for postfixadmin. You need to backport the version from testing and make it available to install.


some example hiera configs to configure postfixadmin:


postfixadmin::db::dbtype: 'mysqli'
postfixadmin::db::dbpass: 'adminpostfix'

postfixadmin::vhost::servername: ''

# we do not want ssl ;(
postfixadmin::vhost::ssl: false
postfixadmin::vhost::port: '80'
postfixadmin::vhost::docroot: '/usr/share/postfixadmin/public'

postfixadmin::ensure_database: true
postfixadmin::ensure_vhost: true
postfixadmin::ensure_postfix_queries: true
    admin: ''
    password: 'P0stf1x'
    # must include two digits
    superadmin: true
    #send_mail: true
    # does not work out of the box, needs a mailer installed

    domain: ''

apache::mpm_module: 'prefork'
# needed by apache

Manage domains using cli

using postfixadmin::cli::create_admin

using postfixadmin::cli::create_domain

using postfixadmin::cli::create_aliasdomain

you can create admins, domains and aliasdomains using puppet.


Please report bugs and feature request using GitHub issue tracker.

For pull requests, it is very much appreciated to check your Puppet manifest with puppet-lint and the available spec tests in order to follow the recommended Puppet style guidelines from the Puppet Labs style guide.


This module is mainly written by Cirrax GmbH.

See the list of contributors for a list of all contributors.