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

Upgrade iRedAPD

iRedAPD source code is hosted on BitBucket.

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.

We provide 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.

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

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

That's all.

---

Important notes:

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

• Plugin amavisd_wblist and amavisd_message_size_limit requires access to Amavisd SQL database, if you're upgrading iRedAPD from iRedAPD-1.4.3 or older releases, don't forget to copy amavisd_db_* settings from sample config file and set correct values:

# For Amavisd policy lookup and white/blacklists.
amavisd_db_server = '127.0.0.1'
amavisd_db_port = '3306'
amavisd_db_name = 'amavisd'
amavisd_db_user = 'amavisd'
amavisd_db_password = 'password'

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

• Since version 1.4.4, iRedAPD supports other Postfix smtp protocol states, e.g. END-OF-MESSAGE, so you can enable iRedAPD in Postfix setting smtpd_end_of_data_restrictions like below:

  smtpd_end_of_data_restrictions = check_policy_service inet:127.0.0.1:7777, ...

  Currently, only plugin amavisd_message_size_limit works in END-OF-MESSAGE state, other plugins work in RCPT state.