Customers will be pleased to note we now support "mailman" which is a web based, easy to use mailing list management tool. It is automatically enabled for all lists, and customers can login to it at http://list.theirdomain.dom/. When you go to create your initial list you will need to use your control panel password in the "List creator's (authentication) password:" field.
Before you use a domain name for the first time please email a request to email@example.com specifying the domain name so that we can enable mailing lists on that domain. It will take 1 hour for this to take effect.
You must have a unix shell account (part of the developer account and higher) in order to use mailing lists.
Every domain name is assigned a sub domain lists.domain.dom and the mail for this is handled by ~/.qmail-lists-* so, for completeness mail for the mailing list firstname.lastname@example.org, for the user "joe" will
be delivered to ~joe/.qmail-lists-wibble
Ezmlm takes advantage of this. In addition, we can use our mail forwarding system and a small kludge to make ezmlm think that the mailing list is actually email@example.com. Note that mail for domain.co.uk does not go through your .qmail files, we have a better, distributed mail forwarding system for this, which supports the kludge.
Ezmlm lists are generally managed from the command line. There are two ways of setting them up. You may either use the ezmlm commands directly, or you may use our simplifed interface to these commands which makes mailing list management much easier.
Using the simplified commands
The "simplified commands" are a set of scripts we have developed that act as an interactive question and answer "wizard" through the mailing list creation and management process.
Running any of these commands without any options will give a detailed help message.
The simple commands will create a directory in your user area called "ezmlm" and it will place all the configuration files for the mailing lists into that directory.
This means that existing mailing lists created with ezmlm manually will not work with these tools.
list-add, list-list and list-remove will all work with any ezmlm directories. It checks ~/ezmlm/ first, but will then try it as a full directory.
To create a mailing list, use the "list-make" program. (Just type "list-make" at a unix command prompt.) You will be asked a series of questions and given some final instructions for your mailing list.
To add users to the mailing list use the "list-add" program.
This program requires two arguments. the first is the list name, and the second is either an email address or the name of a text file containing email addresses. For example:
list-add testlist firstname.lastname@example.org
list-add testlist ~/testlistmembers.txt
To remove users from the mailing list use the "list-remove" program. This program requires two arguments. the first is the list name, and the second is either an email address or the name of a text file containing email addresses. For example:
list-remove testlist email@example.com
list-remove testlist ~/testlistmembers.txt
Also, you can use the "list-list" program to list the subscribers to your mailing list:
Finally, you need to create a mail forwarding rule for firstname.lastname@example.org to email@example.com. Do this using the control panel. When doing this, check the suffix match box to enable the forwarding system to send all the ezmlm mail aliases to the right place.
Then, to send mail to the list just mail firstname.lastname@example.org
If people want to subscribe, they should send mail to email@example.com.
Using the ezmlm commands
If you want to use the ezmlm commands with lists created using the "simple commands" as described above, simply use ~/ezmlm/discuss where the examples below specify ~/ezmlm
Ezmlm Mailing lists are created using the ezmlm-make program.
People are (un)subscribed using ezmlm-(un)sub
Users can be listed using ezmlm-list
To work through a quick example:
We'll create a member-only discussion list (firstname.lastname@example.org)
ezmlm-make -afijlmnpqurt -5 email@example.com ~joe/discuss ~joe/.qmail-lists-discuss discuss domain.co.uk
This will create a ~/discuss/ directory.
For more details about the options you can use when creating a mailing list, read the manual page for ezmlm-make by using the command "man ezmlm-make".
We can subscribe ourselves to it:
ezmlm-sub ~/discuss firstname.lastname@example.org
If I had a text file of members, I could add them to it:
xargs ezmlm-sub ~/discuss < members.txt
I can send myself an email with a membership list:
ezmlm-list ~/discuss | mail email@example.com
If I want something to be pre-pended to the subject line:
echo "[domain-discuss]" > ~/discuss/prefix
If you want to set the reply-to on the list, read this:
If I want to subscribe a moderator:
ezmlm-sub ~/discuss/mod firstname.lastname@example.org
Finally, you need to create a mail forwarding rule for email@example.com to firstname.lastname@example.org. When doing this, check the suffix match box to enable the forwarding system to send all the ezmlm mail aliases to the right place.
Then, to send mail to the list just mail email@example.com