Welcome to Toaster Admin

ToasterAdmin is a QmailAdmin /VqAdmin replacement written in PHP5. It uses a PEAR MVC Framework, and utilizes the new vpopmaild daemon for vpopmail. It is in alpha stage right now, and requires vpopmail 5.4.26.

ToasterAdmin requires vpopmaild. To run vpopmaild, you can use this simple run script for use with daemontools: 

#!/bin/sh
QMAILDUID=`id -u root`
NOFILESGID=`id -g root`
MAXSMTPD=`cat /var/qmail/control/concurrencyincoming`
exec /usr/local/bin/softlimit -m 8000000 \
    /usr/local/bin/tcpserver -v -H -R -l 0 \
    -u "$QMAILDUID" -g "$NOFILESGID" 0 89 \
    /home/vpopmail/bin/vpopmaild 2>&1

vpopmail installation is not covered here.

Features

  • Add/Remove Domains, Users, Forwards, and Auto-Responders
  • Modify Default Domain Limits
  • Modify User Limits (including quotas)
  • Search for Domains
  • Modify user mail routing and vacation messages
  • Add Alias Domains
  • Manage IP Maps
  • Internationalization support via gettext (en, tr, pt_BR, nl, it)
  • Works with SSL. Just prefix your hostname with ssl://

Planned Features

  • Modify System Default Limits (vlimits.default)
  • simcontrol support
  • More Translations! ToasterAdmin fully supports internationalization.
  • EZMLM Support (must be supported by vpopmaild first)

ScreenShots

Requirements

ToasterAdmin requires PHP 5 with mcrypt, sockets, and gettext extensions enabled. It has a few PEAR dependencies, which are included in the current release. For details on installing them manually, see the manual Installation notes.

Download

The latest release is available here, and has the PEAR dependencies bundled.

ToasterAdmin is also available via subversion checkout (no PEAR deps bundled). To check out the svn source anonymously, use this command: 

svn co svn://trac.merchbox.com/toasteradmin/trunk toasteradmin

Configure

(Replace x.x.x with your version) 

chmod a+w toasteradmin-x.x.x/Framework/Site/Default/Templates/Default/templates_c
chmod a+w toasteradmin-x.x.x/Framework/Site/Default/Templates/Default/cache

Then make toasteradmin-x-x-x/htdocs the document root for your apache config.
If you are running a system-wide PEAR install, you'll also need to edit the $ta_include_path variable to not include the local copy of PEAR. See the comments in htdocs/index.php for details.

Lastly, edit toasteradmin-x.x.x/Framework/Site/Default/config.xml, and change vpopmaildHost to your IP or hostname running vpopmaild. Change other settings as necessary.

Support

ToasterAdmin is discussed on the toaster@shupp.org (archive) mailing list. Send an email to toaster-subscribe@shupp.org to join the list.

Enjoy!
Bill Shupp

Documentation on Trac

For a complete list of local wiki pages, see TitleIndex.