Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A plugin to migrate mailboxes using IMAP

Project description

Mailboxes migration using OfflineIMAP

ghw codecov

A simple Modoboa extension which provides a way to migrate existing mailboxes using OfflineIMAP.

How does it work

This extension mainly provides a cron script which periodically synchronize user mailboxes from an existing IMAP server to a new one. The workflow is pretty simple:

  • A user from the old server logs into Modoboa using the same credentials
  • A new account is automatically created and a new migration task is created using the provided credentials
  • The cron script periodically synchronizes mailboxes corresponding to migration tasks
  • Once a migration is done, it can be disabled through the admin panel


Install this extension system-wide or inside a virtual environment by running the following command:

$ python install

Then, edit the file of your modoboa instance and add modoboa_imap_migration inside the MODOBOA_APPS variable like this:

  # ...

Then, add the following at the end of the file:

from modoboa_imap_migration import settings as modoboa_imap_migration_settings

Restart the python process running modoboa (uwsgi, gunicorn, apache, whatever).

Run the following commands to setup the database tables:

$ cd <modoboa_instance_dir>
$ python migrate modoboa_imap_migration
$ python load_initial_data
$ python collectstatic

You also need to install OfflineIMAP.


Authentication backend


Please make sure automatic domain/mailbox creation is enabled, otherwise the authentication won’t work. Go to the online settings panel (admin tab) and check your current state.

An IMAP authentication backend is provided by the extension and must be enabled.

Edit the file and modify the AUTHENTICATION_BACKENDS variable as follows:


cron script

The synchronization script must be configured to run periodically on your new server. Since it will copy mailboxes content to its final destination, filesystem permissions must be respected. To do that, it must be executed by the user which owns mailboxes (generally vmail).

Here is a configuration example where the script is executed every hours. You can copy it inside the /etc/cron.d/modoboa file:


0       */1     *       *       *       vmail   cd /srv/vmail && $PYTHON $INSTANCE/ generate_offlineimap_config --output .offlineimaprc && /usr/local/bin/offlineimap > /dev/null 2>&1

Feel free to adapt it.

Online settings

You need to configure the access to the old IMAP server.

All the configuration is done from the admin panel (Modoboa > Parameters > IMAP migration).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for modoboa-imap-migration, version 1.3.4
Filename, size File type Python version Upload date Hashes
Filename, size modoboa_imap_migration-1.3.4-py2.py3-none-any.whl (137.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size modoboa-imap-migration-1.3.4.tar.gz (275.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page