User Tools

Site Tools


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

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.txt · Last modified: 2017/10/18 14:56 by daniel