Introduction

This guide can be seen as an addition to the following: http://128.242.118.41/index.php/Setup_Qmail%2C_Tcpserver%2C_and_Daemontools


Prerequisites:

The following applications must be installed prior to the successful operation of qmailadmin:

1. Qmail ([1])
2. Tcpserver ([2])
3. Daemontools ([3])
4. Vpopmail
5. EZMLM
6. Autoresponder
7. Apache

[edit] Install Vpopmail

1. Download the source:

Shell> cd /usr/local/src
Shell> wget http://internap.dl.sourceforge.net/sourceforge/vpopmail/vpopmail-5.4.25.tar.gz

2. Untar the package:

Shell> tar zxvf vpopmail-5.4.25.tar.gz

3. Create vchkpw group and vpopmail user:

Shell> groupadd -g 89 vchkpw
Shell> useradd -g vchkpw -u 89 vpopmail -d /home/vpopmail

4. Install Vpopmail:

Shell> cd vpopmail-5.4.25
Shell> ./configure --enable-tcpserver-file=/etc/tcp.smtp
Shell> make
Shell> make install-strip

5. (Optional) Add a virtual domain:

Shell> cd /home/vpopmail/bin
Shell> ./vadddomain example.com
please enter password for postmaster:
enter password again:

6. (Optional) Add a test user to the new virtual domain:

Shell> ./vadduser test@example.com
Please enter a password for test@example.com:
enter password again:

[edit] Install EZMLM

1. Download the source:

Shell> cd /usr/local/src
Shell> wget http://www.inter7.com/devel/ezmlm-0.53-idx-0.41.tar.gz

2. Untar the package:

Shell> tar zxvf ezmlm-0.53-idx-0.41.tar.gz

3. Install EZMLM:

Shell> cd ezmlm-0.53-idx-0.41
Shell> make
Shell> make man
Shell> make setup

4. Test the installation:

Create a mailing list:

Shell> /usr/local/bin/ezmlm/ezmlm-make ~/testlist ~/.qmail-testlist me-testlist host

Note: Replace "me" and "host" with your username and host.

Subscribe yourself to the list manually:

Shell> /usr/local/bin/ezmlm/ezmlm-sub ~/testlist me@host

Send a message to the list:

Shell> echo subject:testing | /var/qmail/bin/qmail-inject me-testlist@host

You should receive a copy of the message at me@host

View the list's members:

Shell> /usr/local/bin/ezmlm/ezmlm-list ~/testlist

You should see just one line, containing your address.

Unsubscribe yourself through email:

Shell> /var/qmail/bin/qmail-inject me-testlist-unsubscribe@host < /dev/null

When you receive the confirmation number, reply to complete your unsubscription. You can use ezmlm-list to verify that the list is empty.

Retrieve the first message from the archive:

Shell> /var/qmail/bin/qmail-inject me-testlist-get.1@host < dev/null

You should receive a copy of your subject:testing message.
[edit] Install Autorespond

1. Download the source:

Shell> wget http://www.inter7.com/devel/autorespond-2.0.2.tar.gz

2. Untar the package:

Shell> tar zxvf autorespond-2.0.2.tar.gz

3. Install Autorespond:

Shell> cd autorespond-2.0.2
Shell> make
Shell> make install

[edit] Install QmailAdmin

1. Download the source:

Shell> wget http://voxel.dl.sourceforge.net/sourceforge/qmailadmin/qmailadmin-1.2.11.tar.gz

2. Untar the package:

Shell> tar zxvf qmailadmin-1.2.11.tar.gz

3. Install QmailAdmin:

Shell> cd qmailadmin-1.2.11
Shell> ./configure

           qmailadmin 1.2.11
           Current settings
---------------------------------------
      cgi-bin dir = /var/www/cgi-bin
         html dir = /var/www/html
        image dir = /var/www/html/images/qmailadmin
        image URL = /images/qmailadmin
     template dir = /usr/local/share/qmailadmin
        qmail dir = /var/qmail
     vpopmail dir = /home/vpopmail
  autorespond dir = /usr/local/bin
        ezmlm dir = /usr/local/bin/ezmlm
        ezmlm idx = yes
  mysql for ezmlm = yes
             help = no
     modify quota = no
  domain autofill = no
modify spam check = no

This is what spits out after ./configure is run. If your environment is different you may want to reconfigure with specific options. For more information: ./configure --help

Shell> make
Shell> make install

[edit] Testing

Now that everything is installed go ahead and start Apache (if it isn't running) and open your browser to the following url:

http://your_server_IP/cgi-bin/qmailadmin