iredmail-doc/en_US/upgrade/0-upgrade.iredapd.md

Upgrade iRedAPD

• Release Notes are available here: iRedAPD Release Notes.
• If you're trying to upgrade iRedAPD-1.3.x or earlier releases to the latest iRedAPD, please check this tutorial instead: Upgrade iRedAPD from v1.3.x or earlier versions to latest release.
• iRedMail and iRedAdmin-Pro completely drop support for Cluebringer, if you're still running Cluebringer, please migrate to iRedAPD by following our tutorial.
• We offer remote upgrade service, check the price and contact us.

This tutorial describes how to upgrade iRedAPD from 1.4.0 or later releases to the latest stable release. It's applicable on all Linux/BSD distributions supported by iRedMail.

1. Download the latest stable release here: http://www.iredmail.org/yum/misc/. For example, iRedAPD-1.7.0.tar.bz2.
2. Upload it to your iRedMail server. Assume it's /root/iRedAPD-1.7.0.tar.bz2.
3. Extract downloaded package and execute upgrade script:

Note: If you're running iRedMail with OpenLDAP or MySQL/MariaDB backend, upgrading from iRedAPD-1.6.0 or earlier releases to the latest iRedAPD-1.7.0 requires MySQL root username and password, please get them before you run upgrade script.

# cd /root
# tar xjf iRedAPD-1.7.0.tar.bz2
# cd iRedAPD-1.7.0/tools/
# bash upgrade_iredapd.sh

That's all.

---

Important notes:

• iRedAPD-1.7.0 doesn't enable greylisting by default, please enable plugin greylisting in iRedAPD config file (/opt/iredapd/settings.py), then execute SQL command below to enable server-wide greylisting:

sql> USE iredapd;
sql> INSERT INTO greylisting (account, priority, sender, sender_priority, active) VALUES ('@.', 0, '@.', 0, 1);

• It's recommended to enable plugin reject_null_sender in iRedAPD-1.4.4 or later releases to prevent authenticated user sending spam as null sender.

• Plugin amavisd_wblist is required if you manage white/blacklists with iRedAdmin-Pro.

See Also

• Migrate Cluebringer to iRedAPD