diff --git a/HowtoMailman.md b/HowtoMailman.md index 2d8ab741..5b01191b 100644 --- a/HowtoMailman.md +++ b/HowtoMailman.md @@ -1,15 +1,42 @@ -**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.** +--- +categories: mail +title: Howto Mailman +... -# Howto Mailman +* Documentation : + +[Mailman](http://www.list.org/) est un logiciel libre de gestion de listes de diffusion. Il est développé en Python depuis plus de 20 ans. Il est souvent utilisé dans projets libres comme Debian, Python, Wikimédia, etc. Il est plus simple que [Sympa](HowtoSympa) car il ne nécessite pas forcément de base de données SQL, mais ses fonctionnalités sont moins avancées. + +> *Le saviez-vous ?* Le 1er jour de chaque mois est parfois appelé *Mailman day* car ce jour là Mailman envoie classiquement un email de rappel d'inscription à tous les inscrits à chaque liste de diffusion. + +## Installation ~~~ # apt install mailman nginx fcgiwrap postfix + +# systemctl status mailman +● mailman.service - LSB: Mailman Master Queue Runner + Loaded: loaded (/etc/init.d/mailman) + Process: 16017 ExecStop=/etc/init.d/mailman stop (code=exited, status=0/SUCCESS) + Process: 16050 ExecStart=/etc/init.d/mailman start (code=exited, status=0/SUCCESS) + CGroup: /system.slice/mailman.service + ├─16062 /usr/bin/python /usr/lib/mailman/bin/mailmanctl -s -q start + ├─16063 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=ArchRunner:0:1 -s + ├─16064 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=BounceRunner:0:1 -s + ├─16065 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=CommandRunner:0:1 -s + ├─16066 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=IncomingRunner:0:1 -s + ├─16067 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=NewsRunner:0:1 -s + ├─16068 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=OutgoingRunner:0:1 -s + ├─16069 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=VirginRunner:0:1 -s + └─16070 /usr/bin/python /var/lib/mailman/bin/qrunner --runner=RetryRunner:0:1 -s ~~~ -Configuration basique via le fichier /etc/mailman/mm_cfg.py +## Configuration + +Configuration basique via le fichier `/etc/mailman/mm_cfg.py`: ~~~ -DEFAULT_URL_PATTERN = ' +DEFAULT_URL_PATTERN = 'http://%s/' DEFAULT_SERVER_LANGUAGE = 'fr' ~~~ @@ -19,13 +46,15 @@ Il faut obligatoirement définir une liste nommée "mailman" avec listmaster / m # /usr/lib/mailman/bin/newlist mailman ~~~ -On créera également un mot de passe global (a priori pour autoriser la création de listes) : +On créera également un mot de passe global pour autoriser la création de listes : ~~~ # mmsitepass ~~~ -## Configuration avec Nginx +### Configuration avec Nginx + +Exemple de configuration pour [Nginx](HowtoNginx) : ~~~ server { @@ -60,7 +89,7 @@ server { ## Configuration avec Postfix -main.cf : +Ajout dans `/etc/postfix/main.cf` : ~~~ alias_maps = hash:/etc/aliases hash:/var/lib/mailman/data/aliases @@ -70,20 +99,84 @@ transport_maps = hash:/etc/postfix/transport mailman_destination_recipient_limit = 1 ~~~ -transport : +et dans `/etc/postfix/transport` : ~~~ lists.example.com mailman: ~~~ -mm_cfg.py : +Puis dans `/etc/mailman/mm_cfg.py` : ~~~ MTA='Postfix' ~~~ +Et enfin, exécuter ces commandes : + ~~~ # /usr/lib/mailman/bin/genaliases # /etc/init.d/mailman restart # /etc/init.d/postfix restart ~~~ + +## Administration + +### En ligne de commande + +On peut administrer Mailman en ligne de commande ! + +Lister les listes de diffusions : + +~~~ +# list_lists +2 matching mailing lists found: + Mailman - [no description available] + Test - Liste de diffusion pour tests +~~~ + +Lister les admins d'une liste : + +~~~ +# list_admins Test +List: test, Owners: jdoe@example.com +~~~ + +Lister les membres d'une liste : + +~~~ +# list_members Test +jdoe@example.com +test@example.com +~~~ + +Et de nombreuses commandes : `add_members`, `remove_members`, `newlist`, etc. + +### SPF / DKIM / DMARC + +On conseille bien sûr de configurer SPF, DMARC, ainsi que DKIM via [OpenDKIM](HowtoDKIM). + +Pour la configuration d'une liste, on choisira l'option : + +~~~ +Replace the From: header address with the list's posting address to mitigate issues stemming from the original From: domain's DMARC or similar policies. + +MUNGE FROM +~~~ + +### Modifier DEFAULT_URL_PATTERN + + + +Si l'on modifie *DEFAULT_URL_PATTERN* dans le fichier `/etc/mailman/mm_cfg.py`, cela sera pris en compte pour toutes les futures listes **mais** il faut relancer la commande suivante pour que cela soit pris en compte pour les anciennes listes déjà créées : + +~~~ +# /usr/sbin/withlist -l -a -r fix_url +Importing fix_url... +Running fix_url.fix_url()... +Loading list mailman (locked) +Saving list +Loading list test (locked) +Saving list +[...] +Finalizing +~~~