Forge Home

thunderbird

Install Mozilla Thunderbird and configure email accounts for users

5,501 downloads

5,501 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.0.2 (latest)
released May 21st 2018
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • , , , windows

Start using this module

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

Add this module to your Puppetfile:

mod 'puppetfinland-thunderbird', '1.0.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppetfinland-thunderbird
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppetfinland-thunderbird --version 1.0.2

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

puppetfinland/thunderbird — version 1.0.2 May 21st 2018

thunderbird

A Puppet module for installing and configuring Mozilla Thunderbird. It makes heavy use of hash parameters to allow complex configurations on a per-user and per-email account basis. Typically all of the configuration should be placed high-up in the hierarchy, so that every user on every desktop/laptop gets the same Mozilla Thunderbird configuration. The default configuration can then be overridden on a node-by-node basis.

This module has been tested on Linux (Ubuntu 14.04, Debian 8-9) and Windows 7 64-bit. Other *NIX variants such as RedHat, Debian and FreeBSD as well as 32-bit Windows have not been tested, but should work out of the box or with minor modifications. Adding MacOS X support should be fairly straightforward.

Currently there are a few limitations:

  • Only one identity per email account
  • Only system-wide IMAP/POP/SMTP server configuration
  • Only email account details are currently configured
  • No way to reuse global IMAP/POP server info for several accounts of a same system user
  • User's profiles.ini get's overwritten, so does not co-exist nicely with manually configured accounts. This might be considered a feature.

Module usage

Example usage of the class in Hiera:

classes:
    - thunderbird

# Globally defined IMAP/POP servers
thunderbird::servers:
    gmail:
        host: 'imap.gmail.com'
        is_gmail: 'true'
    rackspace:
        host: 'secure.emailsrvr.com'

# Globally defined SMTP servers
thunderbird::smtpservers:
    gmail:
        host: 'smtp.gmail.com'
        port: 587
        try_ssl: 2
        auth_method: 3
        description: 'Gmail SMTP server'
    rackspace:
        host: 'secure.emailsrvr.com'
        port: 465
        try_ssl: 3
        auth_method: 1
        description: 'Rackspace SMTP server'

# User profiles (one per system user)
thunderbird::profiles:
    john:
        accounts: 'john_gmail,john_rackspace'
        defaultaccount: 'john_gmail'

# Email account details. One or more per user.
thunderbird::userconfigs:
    john_gmail:
        username: 'john'
        email: 'john.doe@gmail.com'
        fullname: 'John Doe'
        organization: ''
        server: 'gmail'
        server_realusername: 'john.doe'
        smtpserver: 'gmail'
    john_rackspace:
        username: 'john'
        email: 'john@domain.com'
        fullname: 'John Doe'
        organization: 'ACME Terraforming, Inc.'
        server: 'rackspace'
        smtpserver: 'rackspace'

For details see these manifests: