Much of this developer documentation provides historical context but may not reflect the current state of the project.
If you see outdated content please navigate to the page footer and click "Report an issue on GitHub".

It is not user documentation and should not be treated as such.

User Documentation is available here.

Configuration for

These configuration details are derived from notes taken during the installation and configuration of

Overall configuration details

Trimmed all unneeded packages from system to get base install, or use a base image that is already minimal.

Configured firewall to allow ports 22, 25, 80, and 443:

cat /tmp/
iptables -F
iptables -X
iptables -I INPUT -p icmp -j ACCEPT
iptables -A INPUT -d -j ACCEPT
iptables -A INPUT -p tcp --dport 22 -j ACCEPT
iptables -A INPUT -p tcp --dport 25 -j ACCEPT
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
iptables -A INPUT -p tcp --dport 443 -j ACCEPT
iptables -A INPUT -m state --state new -j REJECT 
service iptables save

Set IP address to static in: ‘/etc/sysconfig/network-scripts/ifcfg-eth0’

Installed mailman and postfix:

yum install mailman postfix

Configured Postfix to listen to the external interface and for all the domains you want. These are the parameters set differently from default for

myhostname =
inet_interfaces = $myhostname, localhost,
mydestination = $myhostname, localhost.$mydomain, localhost, $mydomain,
relay_domains = $mydestination,,

Mailman configuration

In ‘/etc/httpd/conf.d/mailman.conf’ set ‘/mailman’ to redirect to listinfo page:

# Uncomment the following line, to redirect queries to /mailman to the
# listinfo page (recommended).

RedirectMatch ^/mailman[/]*$ /mailman/listinfo

NOTE: Normally a Mailman-only host would have ‘/’ redirected. This may be disabled because is serving at ‘/’.

# RedirectMatch ^/[/]*$ /mailman/listinfo

Edited ‘/etc/mailman/’ and configured:


Restarted Apache.

Added new virtual host to ‘/etc/httpd/conf.d/’:

<VirtualHost *:80>
    DocumentRoot /var/www/html/
    ErrorLog logs/
    CustomLog logs/ common

Ran ‘chkconfig {httpd,postfix,mailman,iptables} on’.

Ran ‘/usr/lib/mailman/bin/mmsitepass’ to set mailman password.

Ran ‘/usr/lib/mailman/bin/newlist’ to create a new list. Add the password to the file ‘/root/passwords’.

Don’t forget to add sections to ‘/etc/aliases’ for each mailing list, then run ‘newaliases’.

To finish creating your mailing list, you must edit your /etc/aliases (or
equivalent) file by adding the following lines, and possibly running the
`newaliases' program:

## mailman mailing list
mailman:              "|/usr/lib/mailman/mail/mailman post mailman"
mailman-admin:        "|/usr/lib/mailman/mail/mailman admin mailman"
mailman-bounces:      "|/usr/lib/mailman/mail/mailman bounces mailman"
mailman-confirm:      "|/usr/lib/mailman/mail/mailman confirm mailman"
mailman-join:         "|/usr/lib/mailman/mail/mailman join mailman"
mailman-leave:        "|/usr/lib/mailman/mail/mailman leave mailman"
mailman-owner:        "|/usr/lib/mailman/mail/mailman owner mailman"
mailman-request:      "|/usr/lib/mailman/mail/mailman request mailman"
mailman-subscribe:    "|/usr/lib/mailman/mail/mailman subscribe mailman"
mailman-unsubscribe:  "|/usr/lib/mailman/mail/mailman unsubscribe mailman"

Resources used


Category:Infrastructure documentation