User Tools

Site Tools


This is an old revision of the document!

Manitou-Mail Wiki

Welcome to the Wiki for Manitou-Mail, a database-driven mail user agent.


manitou-mdx is a Perl program that is responsible for importing incoming mail into the database, and exporting outgoing mail to a Mail Transfert Agent. MDX stands for Mail Database eXchanger. It generally runs as a daemon (a permanent process in background) although it can also be invoked as a normal command to import existing mailboxes.
Its functionalities can be vastly extended by user-contributed plugins written in the Perl language.

The main documentation for manitou-mdx is part of the Manitou-Mail's manual.

Additional information is available on this wiki:

  • Debian package How to create a debian package from scratch for manitou-mdx.
  • Filters On the use of server-side mail filters.
  • Word extractors External scripts that extract text from attachments for the full-text indexer.

The Plugins page provides documentation and sample plugins.

manitou-mdx can be monitored with Nagios


manitou-spool is a very simple shell maildrop script that copies its standard input into a separate file with a unique name in a spooldir. It is meant to be called by programs such as fetchmail or an stmp server through an entry in the /etc/aliases file. Tips about the spool directory

Database schema

The current version of an installed Manitou-Mail database can be queried in SQL by:

SELECT rt_value FROM runtime_info WHERE rt_key='schema_version'

A visual representation of the schema can be seen on this diagram (although it's not current, it doesn't differ that much from newer versions of the schema)

schema_grants for the latest version.

Version 1.0.0 and above

Upgrade script To upgrade the db schema from 0.9.12

Starting from 1.0, it's also possible to perform a schema upgrade to the latest version by this shell command:

$ manitou-mgr --upgrade-schema

“Latest” here means the latest known to the manitou-mgr command.

Access rights Scripts to grant access rights for multi-user installations

User Interface

NSIS script for Windows The script that is used to create Manitou-Installer.exe

Source code The C++ source code can be read online (one HTML page per file)

SQL tips and queries

start.1383652372.txt.gz · Last modified: 2013/11/05 12:52 by daniel