Getting Started
You must have a working MailScanner set-up and have running copies of:
- MySQL (5.7 or greater is recommended for full UTF-8 support, and MariaDB 10.1-10.5 is reported working well too)
- Apache / Nginx / Caddy
- PHP 5.6 or better (with MySQL and GD support), using the last stable and supported version is highly suggested
And for MailScanner CustomConfig modules to be able to use a work, you need:
- Perl
- DBI
- DBD::MariaDB
- Encoding::FixLatin
- Digest::SHA
Please read through the installation/upgrading instructions in their entirety before proceeding.
Upgrading DBD::MariaDB
Linux distributions don’t always ship an updated DBD::MariaDB version: for example, Debian 10 ships version 1.11, which isn’t fully compatible with the latest MariaDB Server.
MailWatch works well with DBD::MariaDB version 1.22 or greater, which fully supports UTF8MB4 and a great range of MySQL and MariaDB server versions; to verify your installed DBD::MariaDB version use the following command
$ perl -MDBD::MariaDB -e 'print $DBD::MariaDB::VERSION'
You can update the installed DBD::MariaDB package using cpan:
$ cpan -i DBD::MariaDB
Verify that your installed DBD::MariaDB version is at least 1.22, use the latest version when possible:
$ perl -MDBD::mysql -e 'print $DBD::mysql::VERSION'
Installing Encoding::FixLatin
Encoding::FixLatin can be installed with this command:
$ cpan -i Encoding::FixLatin
Installing Digest::SHA
Digest::SHA1 can be installed with this command:
$ cpan -i Digest::SHA