Sympa Logo
Translations of this page:


Starting version 6.2, you can add plusings to Sympa.

The full list of currently available plugins can be found here: template plugins list.

The documentation about how to write a Sympa plugin in the template plugins documentation.


You may become a contributor :how to contribute to Sympa

Moderation reminder

Benoît Marchal produced a script to remind users that messages are awainting modeartion and / or authentification.

This is usefull to prevent overbooked moderators from forgetting messages in your spools.

Two warnings:

  • the script contains, at the beginning, hard-coded values (directories and names) that you should edit to match you own server,
  • the script is in French and will send messages in French. You should translate it if you wish to use another language.

Download the script:

Steve's Add-ons

Steve Shipway is very active in the Sympa community. He wrote a bunch of add-ons to Sympa. On of them is allowing mail trecking based on the merge feature. The other one is enabling white/black listing in mailng lists.

You can find all these add-ons on Steve's web site.

PgSQL upgrade

Here is a query that eases migration from 5.0 to 6.1.17:


Many thanks to R. boufenghour (Linagora) for this contribution!

css, customized templates, etc

Do you want to win a Sympa tee shirt ? Add your CSS, customized templates or colors proposition in the customize section.

Easy configuration for Postfix

B. Roucaries wrote this script that makes using postfix with Sympa easy.

Install this file as /var/lib/sympa/bin/

It will replace any configuration.

On the sympa side we should ask to not generate alias (by setting the alias_manager parameter value to /bin/true) and it will automagically configure.

To configure a virtual domain ( to connect to sympa, edit Postfix thusly:


      relay_domains = ...
      transport_maps = hash:/etc/postfix/transport
      sympa_destination_recipient_limit = 1


    sympa unix  -       n       n       -       -       pipe
      flags=FR user=sympa
      argv=/var/lib/sympa/bin/ ${nexthop} ${mailbox}

/etc/postfix/transport   sympa:

Note that (root|postmaster|abuse|mailer-daemon|sympa-request|sympa-owner|listowner) are redirected to

Migrations and archives

We received a lot of contribs related to migration and:or archives. Please browse the section of the contribs repository dedicated to migration and archives.

Mail to News gateway

(Marco Gaiarin)

Marco has provided a script that wraps around Sympa's mhonarc call to do a mail→news gateway.

Making many lists using LDAP and Sympa instanciation - March 2007

(Jean-Hugues Belpois)

This document describe how to make/update lists automatically from an LDAP directory. This is use for making/updating students lists in a university environnement, but can easily be adpated to others. Two files are availables :

LemonLDAP plugin - December 2006

LemonLDAP is a Single Sign-On system.

The authentication module for Sympa :

Reset of traffic lists statistics - January 2007

By using this small shell script you can (re)set to zero the trafic statistics (i.e : the number of emails send to the list) of all the lists of a sympa server. To do that, you must :

Statistics module for Sympa - June 2006

(Patrick von der Hagen)

This plugin for Munin, collects statistics about the spools of Sympa :

* [[|Download the plugin]]
* [[|Sample output]]

sympa-milter - November 2006

(Jose-Marcio Martins da Cruz)

This milter checks each (enveloppe) recipient to see if it's one of the lists managed by Sympa, and if it finds any, it adds a header X-Sympa-RCPT to the message. This header allows Sympa to retrieve full original recipient information including “plussed” addresses, before any rewriting done by sendmail.

* [[|sympa-milter homepage]] 

LDAP based alias management

(Ludovic Marcotte)

This contrib replace it for ldap based alias management. It is now distributed with Sympa, starting with Sympa 5.2. Read comment from Ludovic

Coupling Sympa and DokuWiki

Apache::authSympa authentication/authorization module

The goal is to control access to some resources using subscribers definition for a particular list.

* [[|Documentation of the module]]

Uportal Sympa chanel

(esup-portail consortium)

A soap client to be included in u-portal product (need It use SSO authentication based on CAS proxy credential.

    * [[]]

dumping subscribers data

(Michelle Murrain)

The script extracts data from sympa, and either prints a list of email addresses to STDOUT, outputs a comma-delimited file with the fields you want, or maps the data to a database of your choice (postgres or mysql), and INSERTS lines. (no update yet)

    * [[|]]

PHP SOAP Library

(Sébastien Santoro)

This script, based on the SOAP extension of PHP 5, allows using the Sympa SOAP interface.

Ruby SOAP Library

a ruby Sympa soap interface from Daniel Berger

How to share Sympa Session with other PHP applications

(Chris Hastie)

I put together to enable an existing PHP application to set Sympa's session cookie. Obviously all the authentication logic is handled by the PHP app. Once that is satisfied that the user should be authenticated to sympa it can use this class to make the appropriate updates to sympa's session_table, then set a cookie:

include ('SympaSession.php');
$ss = new SympaSession($email);
$sympa_session_id = $ss->getid();
setcookie("sympa_session", $sympa_session_id, 0, '/',
$sympa_session_domain, FALSE);

It suits my purposes, but is not hugely flexible. See it as an example to be modified, not a fully tested and guaranteed working class.

download SympaSession.php.tar.gz

a custom archiver engine based on a database

Starting with Sympa 6, mhonarc can be replaced by some other archiver engine. Here is one based on MySQL, it may use as an example for any other. The program is plugued in Sympa by editing wwsympa.conf to add the custom_archiver parameter with the path of this program asx parameter.

reporting spam plugin for Sympa

Starting in version 6.2, Sympa moderatition allow list moderator to report undetected spam message that are waiting in moderation spool. When choosing this option, messages are rejected without notification but in addition, the related message as stored by Sympa is flushed in the standrd input of an external script. This pluggin script can be designed in order to transfert the message to the appropriate location preserving headers. See reporting_spam_script_path robot parameter.

The following tar includes 2 perl scripts as example of such plugin.

  • one send a message using ”Abuse Report Format
  • one push the spam mesage to an imap folder (probably a very simple solution to collect spam preserving headers) (listcreatemodify)

Script to assist with list family modifications and to automate some features:

  • Create a new list
  • Add a new list to an existing family
  • Instantiate a new family, or update changed settings on a family
  • Remove a list, keeping an archive
  • Remove a list completely
  • Automate customization of footer

List vacation message

Uses a CustomCondition to send a vacation message when in date range.

List vacation message

contribs/index.txt · Last modified: 2016/03/22 11:57 by

The Sympa software is provided by RENATER
Faq | News | Contact | Legal Notices