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)

Access rights Scripts to grant access rights for multi-user installations. 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.

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.1406034577.txt.gz · Last modified: 2014/07/22 15:09 by daniel