sympa

Table of Contents

1. Description
2. Setup - The basics of getting started with sympa
   • What sympa affects
   • Setup requirements
   • Beginning with sympa
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module

Description

This module install a mailing list server named Sympa.

Setup

What sympa affects

With manage_user at true the module creates a local account on system.

With manage_database at true the module installs a PostgreSQL database server and database with role.

Setup Requirements

As a web app, you have to configure a web server. To do so with Puppet, it is possible to use :

• puppetlabs-apache
• puppet-nginx

Beginning with sympa

The very basic steps can be simple :

include sympa

But it's better to change db_password at least.

Usage

To customize topics :

class { 'sympa':
  topics => {
    'topic1' => {
      'en' => 'Topic one in English',
      'fr' => 'Cathégorie une en Français',
    },
  },
}

Reference

Details are in REFERENCE.md file.

Limitations

The module is currently able to manage lists only with one domain. Several domains with robots are not managed.

Supported OSes are given in metadata.json file.

This module support only PostgreSQL as backend.

Development

Home at URL https://gitlab.adullact.net/adullact/puppet-sympa

Issues and MR are welcome.

Release Notes/Contributors/Etc.

Details in CHANGELOG.md.

Copyright (C) 2025 Association des Développeurs et Utilisateurs de Logiciels Libres
                     pour les Administrations et Colléctivités Territoriales.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/agpl.html>.