iRedMail   //  Document Index

Migrate old iRedMail server to the latest stable release

Since new iRedMail server will install same components as old server, you can choose what data you want to migrate.

Most important data are:

• email accounts stored in SQL/LDAP.
• user mailboxes. Stored under /var/vmail by default.
• SQL database of Roundcube webmail. It stores per-user webmail preferences, and address book.
• Policyd/Cluebringer database. It stores white/blacklists records, greylisting records, etc. Note: Policyd/Cluebringer were removed since iRedMail-0.9.3.
• Amavisd database.
  • It stores per-recipient white/blacklists in SQL tables: mailaddr, policy, users, wblist.
  • Basic info of in/out emails are stored in SQL tables: maddr, msgs, msgrcpt. Quarantined emails are stored in quarantine, it requires other 3 tables. If you don't have any quarantined emails, it's safe to delete all records in these 4 tables.

Client settings (Outlook, Thunderbird)

Since iRedMail-0.8.7, iRedMail enforces secure POP3/IMAP/SMTP connections, please update your mail client applications to use TLS connection.

• For SMTP service, use port 587 with STARTTLS (or TLS).
• For IMAP service, use port 143 with STARTTLS (or TLS), or port 993 with SSL.
• For POP3 service, use port 110 with STARTTLS (or TLS), or port 995 with SSL.

LDAP: migrate mail accounts

Steps to migrate LDAP mail accounts:

• Setup a new server with the latest iRedMail, and make iRedAdmin-Pro-LDAP work as expected.
• Export mail accounts from LDAP on OLD mail server.

Normally, LDAP data can be exported into LDIF format. Here's backup/restore procedure: Backup and Restore.

Notes:

• There might be some changes in LDAP schema, please find scripts here to apply all required changes.
• Here are all upgrade tutorials for iRedMail.

MySQL/PostgreSQL: Migrate mail accounts

All mail accounts are stored in database vmail.

• If both old and new servers are running same iRedMail version, you can simply export vmail database on old server, then import it on new server.

• If old server is running an old iRedMail version, there might be some changes in SQL structure, please read all upgrade tutorials for the old iRedMail release, then apply SQL structure related changes to make sure old server has same SQL structure. After you have same SQL structure on both servers, you can simply export vmail database on old server, then import it on new server. Check upgrade tutorials for iRedMail.

Migrate mailboxes (Maildir format)

• Copy all mailboxes (in Maildir format) to new iRedMail server with tools like rsync.

• Set correct file owner and permission of mailboxes. Default owner is vmail, group is vmail, permission is 0700.

• With SQL backends, you can get full maildir path of user with below SQL command:

mysql> USE vmail;
mysql> SELECT CONCAT(storagebasedirectory, '/', storagenode, '/', maildir) FROM mailbox WHERE username='user@domain.com';

• With OpenLDAP backend, full maildir path is stored in LDAP attribute homeDirectory of mail user object. You can query with ldapsearch command:

$ ldapsearch -x -D 'cn=Manager,dc=xx,dc=xx' -b 'o=domains,dc=xx,dc=xx' -W "(mail=user@domain.com)" homeDirectory

Migrate (mlmmj) mailing lists

Mailing lists are stored in 2 places:

• Mailing list accounts are stored in SQL database (for iRedMail SQL backends) or LDAP (for LDAP backends)
• Mailing list data:
  • /var/vmail/mlmmj: it stores active mailing lists.
  • /var/vmail/mlmmj-archive: it stores removed mailing lists.

For mailing list accounts, they should be migrated while migrating mail accounts mentioned in steps above.

For mailing list data, you can simply copy them to new server. After copied, the data must be owned by user/group mlmmj:mlmmj with permission 0700.

Migrate Roundcube webmail data

• Export/import roundcube webmail database, and upgrade database to work with new version of Roundcube.

Reference: https://github.com/roundcube/roundcubemail/wiki/Upgrade

Migrate Amavisd, iRedAPD, iRedAdmin databases

Export those database on old server, then import them on new server.

Migrate DKIM keys

Amavisd will read DKIM keys and sign outgoing emails. DKIM keys are stored under /var/lib/dkim by default, you can copy all keys under this directory to new server, and make sure they have correct file owner amavis:amavis and permission 0600.

If you prefer generating new DKIM keys on new server, don't forget to update DNS records for mail domain names.

Post-migration

After migration, please recalculate mailbox quota by following this tutorial:

• Force Dovecot to recalculate mailbox quota

References

• Password hashes
• Reset user password
• Why append timestamp in maildir path