Upgrade iRedMail from 1.6.1 (or 1.6.2) to 1.6.3

Attention

Check out the on-premises, lightweight email archiving software developed by iRedMail team: Spider Email Archiver.

Paid Remote Upgrade Support

We offer remote upgrade support if you don't want to get your hands dirty, check the details and contact us.

ChangeLog

General (All backends should apply these changes)

Update /etc/iredmail-release with new iRedMail version number

iRedMail stores the release version in /etc/iredmail-release after installation, it's recommended to update this file after you upgraded iRedMail, so that you can know which version of iRedMail you're running. For example:

1.6.3

Disable TLSv1 and TLSv1.1 in Postfix

Attention

WARNING: CentOS 7

Do not apply this on CentOS 7, because TLSv1 is still required by Roundcube with old PHP 5.4. You should consider upgrade CentOS to at least CentOS Stream 8 or Rocky Linux 8, or AlmaLinux 8 as soon as possible.

Run shell commands below as root user to disable TLSv1 and TLSv1.1 for SMTP service:

postconf -e smtpd_tls_protocols='!SSLv2 !SSLv3 !TLSv1 !TLSv1.1'
postconf -e smtpd_tls_mandatory_protocols='!SSLv2 !SSLv3 !TLSv1 !TLSv1.1'
postconf -e smtp_tls_protocols='!SSLv2 !SSLv3 !TLSv1 !TLSv1.1'
postconf -e smtp_tls_mandatory_protocols='!SSLv2 !SSLv3 !TLSv1 !TLSv1.1'
postconf -e lmtp_tls_protocols='!SSLv2 !SSLv3 !TLSv1 !TLSv1.1'
postconf -e lmtp_tls_mandatory_protocols='!SSLv2 !SSLv3 !TLSv1 !TLSv1.1'
postfix reload

Upgrade iRedAPD (Postfix policy server) to the latest stable release (5.3)

Please follow below tutorial to upgrade iRedAPD to the latest stable release: Upgrade iRedAPD to the latest stable release

Upgrade iRedAdmin (open source edition) to the latest stable release (2.3)

Please follow below tutorial to upgrade iRedAdmin to the latest stable release: Upgrade iRedAdmin to the latest stable release.

Upgrade Roundcube webmail to the latest stable release (1.6.1). WARNING: There're breaking changes.

CentOS 7: please stick to Roundcube 1.5.2

If you're running CentOS 7, please upgrade to Roundcube 1.5.2 instead. Roundcube 1.5.3 requires PHP-7, but CentOS 7 ships PHP-5.4 which is not supported by Roundcube 1.5.3 (and the latest 1.6.0).

It's time to leave your comfort zone and upgrade this server to CentOS Stream 8 or Rocky Linux 8.

Ubuntu 18.04: please stick to Roundcube 1.5.x

Ubuntu 18.04 runs old php version, v1.5.x contains the security fix too. Please consider upgrading your OS to 20.04 LTS as soon as possible.

PHP Version

Roundcube 1.6.x requires PHP 7.3 or later releases.

Please follow Roundcube official tutorial to upgrade Roundcube webmail to the latest stable release:

Attention

Please remove file /opt/www/roundcubemail/composer.json before upgrade.

Few changes are required if you upgrade from Roundcube 1.5.x or earlier to 1.6.x:

$config["smtp_host"] = "tls://127.0.0.1:587";
$config["imap_host"] = "tls://127.0.0.1:143";
$config['auto_create_user'] = true;
$config["managesieve_host"] = "tls://127.0.0.1:4190";

Upgrade netdata to the latest stable release (1.39.1)

If you have netdata installed, you can upgrade it by following this tutorial: Upgrade netdata.

For MySQL/MariaDB backends

Add missing index for SQL column forwardings.forwarding

Please run shell commands below as root user to add missing SQL index:

mysql vmail -e "ALTER TABLE forwardings ADD INDEX forwarding (forwarding);"