# ---------------------------------------------------------------------- # Post-installation instructions for the FreeBSD port/package of Mailman # $FreeBSD: ports/mail/mailman/files/FreeBSD-post-install-notes,v 1.6 2006/05/09 18:07:54 jmelo Exp $ # ---------------------------------------------------------------------- CONTENTS: * VERY IMPORTANT NOTE 1) General post-installation instructions 2) Integrating Mailman with your web server 3) Integrating Mailman with various mail servers 3.1) Sendmail 3.2) Exim 3.3) Postfix 3.4) Qmail 4) Apache configuration VERY IMPORTANT NOTE The Mailman port has a number of build time options. Getting the values of some of these right is CRUCIAL if you want your Mailman installation to work! 1) General post-installation instructions You should find two files named "INSTALL" and "README" in the same directory as this file. You should read them for general post-installation instructions. Bear in mind that the installation of Mailman from the FreeBSD port or package may have already taken care of many of the steps you may read about in these files. Also, not everything in these files is necessarily relevant to the FreeBSD port. 2) Integrating Mailman with your web server You need to set up your webserver to find Mailman's CGI scripts. The Mailman port works well with either Apache 1.3.x or Apache 2.x as installed from their respective ports (www/apache13 and www/apache2). If you're using Apache, you need to add at least two lines to your httpd.conf. Assuming that you installed the Mailman port in the default location (/usr/local/mailman), they are: ScriptAlias /mailman "/usr/local/mailman/cgi-bin" Alias /pipermail "/usr/local/mailman/archives/public" If you installed the Mailman port to a non-standard location, replace "/usr/local/mailman" as appropriate. If your Apache is configured for multiple virtual servers, ensure that the above configuration lines appear in all the relevant sections. Remember to restart your Apache server after you have changed httpd.conf! No specific instructions exist at this time on how to integrate the Mailman port with web servers other than Apache. Please submit any such information to the maintainer of the Mailman port. 3) Integrating Mailman with various mail servers 3.1) Sendmail You have to choose SENDMAIL option on config build and port will set MAIL_GID=mailnull to you. When your build is finished, please review the instructions found in mailman-install.txt in the same directory port. The port is designed to work with Sendmail by default. No further instructions exist at this time on how to integrate the Mailman port with Sendmail. Please submit any such information to the maintainer of the Mailman port. 3.2) Exim The following instructions assume that Exim has been set up from the FreeBSD Exim port, and that it runs with a fairly default configuration. Specifically, it assumes that Exim runs under the default UID and GID as configured by the FreeBSD port. In other words, that the following lines appear in Exim's configure file: exim_user = mailnull exim_group = mail For Exim 3.x, the value of MAIL_GID has to be set to 'nobody' (or 65534) when building the Mailman port, so you have to choose EXIM3 on build options to set it to you. For Exim 4.x, the value of MAIL_GID has to be set to 'mail' (or 6) when building the Mailman port, so you have to choose EXIM4 on build options to set it to you. Next, follow the instructions in mailman-install.txt found in the same directory as this file. You can add the macros, transport and router found in mailman-install.txt verbatim to your Exim's configure file. Note that mailman-install.txt as installed with the FreeBSD port of Mailman has been patched, and should be trusted over a version of the file obtained from another source. Specifically, when adding the macros found in mailman-install.txt, you should set the MAILMAN_USER and MAILMAN_GROUP to the same values as those for Exim, namely: MAILMAN_USER=mailnull MAILMAN_GROUP=mail Once you have finished editing configure, remember to re-HUP your Exim server: # kill -1 `cat /var/run/exim.pid` Now, start Mailman's qrunner daemon: # /usr/local/etc/rc.d/mailman start Troubleshooting: If you ever see an error message such as the following in your Exim's mainlog, it's a sure sign that Exim and Mailman disagree about the GID under which mail is delivered: ** testlist@your.host.com R=mailman_router T=mailman_transport: Child process of mailman_transport transport returned 2 from command: /usr/local/mailman/mail/mailman In this case, ensure that you have followed the instructions in this section to the letter. 3.3) Postfix The value of MAIL_GID has to be set to 'nobody' (or 65534) when building the Mailman port, so you have to choose POSTFIX on build options to set it to you. NOTE: the group needs to be 'mailman' if you are using the Mailman integration for generating the postfix virtual and aliases files. Review the instructions found in mailman-install.txt in the same directory as this file. 3.4) Qmail The maintainer of the Mailman port has no information at this time as to the required value of MAIL_GID for Mailman to work with Qmail. :-( Review the instructions found in mailman-install.txt in the same directory as this file. No further instructions exist at this time on how to integrate the Mailman port with Qmail. Please submit any such information to the maintainer of the Mailman port. 4) Apache configuration You should add the follow lines in you httpd.conf to mailman interface works correctly: Options FollowSymLinks ExecCGI AllowOverride None Order allow,deny Allow from all After that, restart your apache: # apachectl restart. -- Jean Milanez Melo (Mailman port maintainer)