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

# Upgrade iRedAPD

> Release Notes are available here: [iRedAPD Release Notes](./iredapd.releases.html).

> 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](./upgrade.old.iredapd.html).

> We offer remote upgrade service, check [the price](../support.html) and [contact us](../contact.html).

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.
1. Upload it to your iRedMail server. Assume it's `/root/iRedAPD-1.7.0.tar.bz2`.
1. 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.