You should read the help page to learn how to use Maia Mailguard:

Here's the settings page for your mail account:

While you browse the Maia web interface, you might encounter some fatal PHP errors, such as this one:

Fatal error: Call to undefined function subtr() in /var/www/maia/wblist.php on line 190

I had to fix the following files to make these errors go away:

vi /var/www/maia/wblist.php

In line 190, there's the line

if (subtr(get_database_type($dbh),0,5) == "mysql") {

The function must be substr, not subtr:

[...]
  //if (subtr(get_database_type($dbh),0,5) == "mysql") {
  if (substr(get_database_type($dbh),0,5) == "mysql") {
[...]

Fatal error: Call to undefined function subtr() in /var/www/maia/cache.php on line 238

Again, we have this subtr error, so change subtr to substr in /var/www/maia/cache.php on line 238:

vi /var/www/maia/cache.php

[...]
        if (substr(get_database_type($this->dbtype),0,5) == "mysql") {
[...]

Fatal error: Call to undefined function response_text() in /var/www/maia/cache.php on line 406

This error can be fixed by simply commenting out line 406:

vi /var/www/maia/cache.php

[...]
        //$this->smarty->assign("actionlang", response_text($this->type));
[...]

Fatal error: Call to undefined function subtr() in /var/www/maia/maia_db.php on line 1954

Here we have the subtr error again - replace subtr with substr:

vi /var/www/maia/maia_db.php

[...]
        if (substr(get_database_type($dbh),0,5) == "mysql") {
[...]

Here are a few more screenshots of the Maia Mailguard interface. Here you can whitelist and blacklist email addresses:

Here's the statistics page:

From the statistics page, you can access your spam and virus mails - they are quarantined, and it's possible to rescue these mails from the quarantine (they will then be delivered to your mailbox), to delete them, or to confirm their status:

12 Creating Cron Jobs For Maia's Maintenance Scripts

Maia Mailguard comes with some maintenance scripts that need to be run regularly. It's best to set up cron jobs that are run by the user amavis:

crontab -u amavis -e

10 * * * * /var/lib/amavis/maia/scripts/process-quarantine.pl &> /dev/null
@hourly /var/lib/amavis/maia/scripts/stats-snapshot.pl &> /dev/null
@daily /var/lib/amavis/maia/scripts/expire-quarantine-cache.pl &> /dev/null
@weekly /var/lib/amavis/maia/scripts/send-quarantine-reminders.pl &> /dev/null
*/10 * * * * /var/lib/amavis/maia/scripts/send-quarantine-digests.pl &> /dev/null

13 Deleting The /var/www/maia/admin Subdirectory

Now that Maia Mailguard is up and running properly, you should delete the /var/www/maia/admin subdirectory for security reasons:

rm -fr /var/www/maia/admin

14 Modifying Email Templates

If you like, you can modify the email templates for emails to users whose quarantines/caches start to get large (/var/lib/amavis/maia/templates/reminder.tpl) and for new users (/var/lib/amavis/maia/templates/newuser.tpl).

The following variables are available for /var/lib/amavis/maia/templates/reminder.tpl:

The following variables are available for /var/lib/amavis/maia/templates/newuser.tpl:

15 Links

• Maia Mailguard: http://www.maiamailguard.com/
• Debian: http://www.debian.org/