Title: qmail notes Subject: more notes on qmail What is it? ~~~~~~~~~~~ QmailAdmin is a cgi program for administering Qmail with vchkpw. Requirements: ~~~~~~~~~~~~~ - A UNIX computer (Linux/Solaris/BSD) and C compiler (gcc) - A web server (Apache, Zeus) - Qmail 1.03 - vchkpw (a virtual domain addon for qmail) - ezmlm installed in /usr/local/bin/ezmlm (modify qmailadmin.h to change location) - autorespond installed in /usr/local/bin/autorespond (modify qmailadmin.h to change location) QmailAdmin is known to work on at least: - Linux - Solaris - FreeBSD Updates? ~~~~~~~~ Latest version is available at: http://www.inter7.com/qmailadmin Please refer your suggestions/bug reports to kbo@inter7.com Install guide 0. fast install guide.. type: ./configure make clean make make install-strip If it works, you are done! If it doesn't.. read below. 1. Before we can make and install there are a few things to consider.. a. do you have a vpopmail user and installed vchkpw b. where is your cgi bin directory c. where is your ezmlm directory d. where is your autorespond directory If you are missing any one of those you can stop reading this now and go install it!! 2. Below is a list of possible configuration options Note: Decide now which features you will want/need for your ./configure *Use this if your cgi bin is not in a standard location --enable-cgibindir={dir} HTTP server's cgi-bin directory. *Use this if your don't want the HTML templates to be in /usr/local/share/qmailadmin --with-htmllibdir={dir} qmailadmin HTML library directory. *Use this if your qmail directory is not in /var/qmail --enable-qmaildir={dir} directory where qmail is installed. *Use this if your URL PATH for cgi-bin is elsewhere --enable-cgipath={/cgi-bin/qmailadmin} URL path for cgi. *use this to set the vchkpw user if it is not vpopuser. --enable-vpopuser={vpopuser} user vchkpw was installed as. *Use this if your autorespond is not in /user/local/bin --enable-autoresponder-bin={path} Path to autoresponder binary. *Use this if ezmlm is not in /usr/local/bin/ezmlm --enable-ezmlmdir={dir} Directory that holds the ezmlm package. *Use this if you would like to set a system wide max pop user limit --enable-maxpopusers=unlimited -1 is unlimited, zero turns off functionality. *Use this to set a system wide max number of aliases --enable-maxaliases=unlimited -1 is unlimited, zero turns off functionality. *Use this to set a system wide max number of forwards --enable-maxforwards=unlimited -1 is unlimited zero turns off functionality. *Use this to set a system wide max number of autoresponders --enable-maxautorepsonders=unlimited -1 is unlimited zero turns off functionality. *Use this to set a system wide max number of mailing lists --enable-maxmailinglists=unlimited default is unlimited or a number. 3. Ok, now configure, using any options that you need to. For example: ./configure --enable-cgibindir=/my/wierd/cgi-bin/dir .... 4. make 5. make install or make install-strip (for a smaller binary) To run it, type into your webrowser: http://yourdomain/cgi-bin/qmailadmin Now.. some fine tuning.. 6. If you want to set per domain limits on the number of: a) pop accounts b) aliases c) forwards d) mailing lists e) autoresponders Then create a .qmailadmin-limits file in the virtual domain directory for the domain you wish to limit. The syntax of the .qmailadmin-limits file is as follows: maxpopaccounts X maxaliases X maxforwards X maxmailinglists X maxautoresponders X Where X is the maximum number you wish. Be sure the vpopmail user has read permissions to this file. The default is unlimited. If you set any of the above values to 0 it will effectually disable that part of the menu and that feature. 7. If you want to modify the "look" of qmail admin: Edit the html template files in /usr/local/share/qmailadmin/ or if you changed the location with the --with-htmllibdir={dir} then edit the files in that directory. 8. Enjoy If you have any questions or comments please email support@inter7.com or join the mailing list at http://www.inter7.com/qmailadmin/