Forge Home

postfixadmin

A module to configure postfixadmin

10,211 downloads

258 latest version

5.0 quality score

Version information

  • 1.2.8 (latest)
  • 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 Jan 4th 2022
This version is compatible with:
  • Puppet Enterprise 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.2.8'
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.2.8

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.

Download

Documentation

cirrax/postfixadmin — version 1.2.8 Jan 4th 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

Overview

This module is used to configure postfixadmin.

It assumes, you are using hiera to configure.

Usage

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.

Examples

some example hiera configs to configure postfixadmin:

---

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

postfixadmin::vhost::servername: 'postfixadmin.example.com'

# 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
postfixadmin::admins:
  admin@example.com:
    admin: 'admin@example.com'
    password: 'P0stf1x'
    # must include two digits
    superadmin: true
    #send_mail: true
    # does not work out of the box, needs a mailer installed

postfixadmin::domains: 
  example.com:
    domain: 'example.com'

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.

Contributing

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.

Authors

This module is mainly written by Cirrax GmbH.

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