Mailman

Installation

You can download mailman from here: http://www.gnu.org/software/mailman/download.html

To verify the download using the signature, add the public keys of the developers listed on the download page, and visit Verifying a File using a Detached Signature at my GnuPG page for the verification process.

Pre-Configure Process

You must first create a group named "mailman" on your system, and create a user named "mailman" in the group "mailman".

# groupadd mailman
# useradd --shell /no/shell --home-dir /no/home --gid mailman mailman

Configuration

For my configuration of mailman, I wanted to make a self-contained installation, including moving the /var/mailman directory (which contains mutable mailman data) into the mailman installation directory. This is the reason for the --with-var-prefix option.

#!/bin/sh

./configure \
    --prefix=${HOME}/pkg/mailman/2.1.14 \
    --with-var-prefix=${HOME}/pkg/mailman/var \
    --with-cgi-gid=503

where the number coming after --with-cgi-gid is the gid for the Apache (or whichever web server) group. In your Apache config file, there is a User and Group listed, which is the user and group that Apache is run as. A corresponding entry can be found in /etc/group, something like:

apache:x:503: 

This number is the gid for Apache, and in order to run cgi scripts, Mailman must run these scripts with this gid.

Before I ran configure, I had to run

$ mkdir -p ${HOME}/pkg/mailman/var
$ /usr/bin/sudo -R chown mailman ${HOME}/pkg/mailman
$ /usr/bin/sudo -R chgrp mailman ${HOME}/pkg/mailman
$ /usr/bin/sudo -R chmod 02775 ${HOME}/pkg/mailman    # <-- the "02" sets UID and GID permissions

(for more info on setting UID and GID permissions, see http://en.wikipedia.org/wiki/Setuid)

NOTE: I acknowledge that using --with-var-prefix is more complicated, but the advantages are, (1) this keeps mailman self-contained, and (2) it is easy to upgrade mailman by installing the new version to ${HOME}/pkg/mailman/X.Y.Z.

Once you've created this directory with the correct permissions, do the usual thing:

$ ./runconfigure.sh
$ make -j2
$ /usr/bin/sudo -u mailman make install # <-- must be run as sudo because
                                        #     creating/modifying directories 
                                        #     owned by "mailman" user

Checking/Fixing Permissions

It is likely you'll run into problems with the permissions, even if you're careful. However, this can be easily fixed using a mailman script:

# cd ${HOME}/pkg/mailman/2.1.14
# bin/check_perms

(any permissions problems will be displayed here)

# bin/check_perms -f

(any permissions problems will be fixed)

(note that this must be run as the superuser, hence the #'s).

Connecting Mailman with Web Server

I'm using an Apache web server. To get Mailman working with Apache, I had to add the following to the httpd.conf file to allow the mailman program to run cgi scripts:

<IfModule alias_module>

    [...]

    # Add a script alias for mailman to run required cgi-scripts
    ScriptAlias /mailman/ "/path/to/mailman/cgi-bin/"

    [...]

</IfModule>

[...]

<Directory "/path/to/mailman/cgi-bin">
    AllowOverride None
    Options ExecCGI
    Order allow,deny
    Allow from all
</Directory>

To add GNU icons, Python-Powered icons, and mailman icons, copy the mailman-provided icons into Apache's icons directory (usually in /path/to/apache/icons):

$ cp /path/to/mailman/icons/*.{jpg,png} /path/to/apache/icons/.

Then you can point to these in the Mailman config file:

$ sudo vim /path/to/mailman/Mailman/mm_cfg.py

by adding the following line:

IMAGE_LOGOS = '/images/'

(default values for most stuff is defined in Defaults.py).

Setting Up Pipermail

Pipermail is a feature of Mailman that archives all of the mailing list's activity and makes it available to users. This is basically what's being put in /var/mailman (or, in case you used the --with-var-prefix configure option above, /path/to/mailman/var).

This can be set up to be accessed via the web:

<IfModule alias_module>

    [...]

    Alias  /pipermail/ "/path/to/mailman/var/archives/public/"

    [...]

</IfModule>

And to properly display international characters, add this:

<Directory "/path/to/mailman/var/archives/public/">
    AddDefaultCharset Off
</Directory>

Connecting Mailman with Mail Server

See Mail Server for details on how to set up a mail server.

I use postfix mail server.

In the Postfix configuration file main.cf, the recipient_delimiter setting should be:

recipient_delimiter = +

In /path/to/mailman/Mailman/mm_cfg.py, add the following line:

MTA = 'Postfix'

MTA is a directory containing instructions for Mailman when lists are created/removed.

Next, Defaults.py should contain the following:

POSTFIX_ALIAS_CMD = '/usr/sbin/postalias'
POSTFIX_MAP_CMD = '/usr/sbin/postmap'

or, wherever your postalias and postmap binaries are located. If they are not, re-define them in mm_cfg.py.

Generate alias files by running the genaliases program:

$ cd /path/to/mailman
$ bin/genaliases

This will create files in the var directory. These should be owned by mailman:

$ cd /path/to/mailman/var/data

$ sudo chown mailman:mailman aliases*

$ sudo chmod g+w aliases*

$ ls -l
-rw-rw---- 1 mailman mailman   368 2011-04-07 18:17 aliases
-rw-rw---- 1 mailman mailman 12288 2011-04-07 18:17 aliases.db
-rw-r--r-- 1 mailman mailman    10 2011-04-07 15:00 last_mailman_version
-rw-r--r-- 1 mailman mailman 14100 2011-04-07 14:59 sitelist.cfg

Then the Postfix main.cf file should contain the following line to point to these aliases:

alias_maps = hash:/etc/aliases, hash:/home/charles/pkg/mailman/var/data/aliases

(/etc/aliases is included because this was the value of alias_maps before pointing it to mailman's aliases).

Mailman Cron Jobs

Mailman uses cron jobs to do routine tasks; these can be added by running

$ /usr/bin/sudo -u mailman crontab /path/to/mailman/cron/crontab.in

Using Mailman

Once you've done all of the above, and restarted your web server, navigate to

http://www.website.com/mailman/listinfo

to view the available mailing lists or

http://www.website.com/mailman/admin

to administer/create mailing lists.