• Enhancement
  • Bug fix

Backward compatibility

New dependencies


Template changes

The following template files have been changed.

  • mailscanner/senders.include
  • settings/policy_rules.html
  • domains/detail.html


Review the release notes for BaruwaOS BaruwaOS 6.8.1 and changelog for version 2.1.4 and read the updated documentation before you proceed with the upgrade.

If you are on versions < 2.0.7, you need to purchase hands on support for a manual upgrade contact support to do so.

Memory Requirements

The minimum memory requirements have changed, if your system is virtual and has less that 6GB of RAM you need to upgrade that to >= 6GB of RAM prior to upgrading. Please note the upgrade process could crash if you to not follow the above recommendation.

Change Management

Ensure you follow your organization change management policy and schedule downtime as well as plan how to revert.

Backup your entire system before you proceed.

Upgrade the baruwa-setup tool

To ensure you have the latest baruwa-setup tool run the following command:

yum install baruwa-setup -y

Backup your baruwa-setup database

Backup your baruwa-setup database by running the following command:

cp -a /var/lib/baruwa-setup/baruwasetup.db /var/lib/baruwa-setup/baruwasetup.db.orig

Run setup utility

To perform the upgrade you run the baruwa-setup command as follows:


Migrate messages to new queue

To copy messages from the old queue into the new queue run the following:

service mailscanner stop
mv -vf /var/spool/exim.in/input/* /var/spool/exim.in/baruwa/input/
service mailscanner start

Monitor logs for issues

You can monitor the relevant logs using the baruwa-logs utility:


If you run into any issues please contact Support

Thats it.