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

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>.