Knowledgebase

Introduction

If you have ever built a mail server from the ground up, you'll know that it can be a tedious venture. There is another option for those of us who don't want to spend the time editing countless configuration files. iRedMail is an amazing shell script that automatically installs and configures all the components necessary for a fully functional mail server. iRedMail uses a complete package of open-source software including:

• Postfix - Mail transfer agent (MTA).

• Dovecot - POP3 and IMAP server.

• Apache, Nginx - Web server.

• OpenLDAP, Idapd - LDAP server for storing mail accounts.

• MySQL, MariaDB, PostgreSQL - SQL server for application data. Can also be used to store mail accounts.

• SpamAssassin - spam scanner.

• ClamAV - Virus scanner.

• Amavisd-new - Interface between Postfix, SpamAssassin and ClamAV.

• Roundcube - Webmail client.

• SOGo Groupware - Calendar, contact and tasks service.

• Fail2ban - Bans IPs that look malicious.

• Awstats - Apache and Postfix log analyzer.

• iRedAPD - Postfix policy server.

In this tutorial, we will walk through all of the steps to get your mail server running and get it secured with SSL using Let's Encrypt.

Prerequisites

• An Ubuntu 16.04 instance with at least 2GB memory. A fresh installation is recommended.

• A non-root sudo user.

• A non-blocked IP address. If your IP address is on a block list it could prevent your emails from ever reaching their destination.

• Verify the server's outbound port status.

Installation With iRedMail

Before getting started with the installation, you should update your system.

sudo apt-get update

sudo apt-get upgrade

Next, we will want to set our fully qualified domain name (FQDN) hostname. On Ubuntu, the hostname is set in 2 files, /etc/hostname and /etc/hosts.

Open /etc/hostname.

sudo nano /etc/hostname

Add your short hostname to the file, not your FQDN. If your full domain is mail.example.com your file should look like this.

mail

Next, open /etc/hosts and add your FQDN.

127.0.0.1   mail.example.com mail localhost localhost.localdomain

Reboot your server.

sudo shutdown -r now

You can now verify your hostname.

hostname -f

Now that your FQDN has been set, we can move onto the installation. Download the latest version of iRedMail using wget. You can find the latest build by visiting the iRedMail download page.

wget https://bitbucket.org/zhb/iredmail/downloads/iRedMail-<VERSION>.tar.bz2

Next, extract the tarball and then cd to the directory.

tar xvf iRedMail-<VERSION>.tar.bz2

cd iRedMail-<VERSION>

Then, add permission to the script and run it with sudo.

chmod +x iRedMail.sh

sudo bash iRedMail.sh

You will see a setup wizard that will ask you some questions:

• Where you would like to store your mailboxes. The default location is /var/vmail.

• Which web server you would like to use.

• The backend to use for storing your mail. If you choose MySQL or MariaDB you will also need to set the SQL root password. This should be a strong password and avoid using special characters as this will cause errors.

• Your first mail domain. This will be your domain from earlier minus the sub-domain. For example if you set your domain as mail.example.com then you would enter example.com as your first mail domain name.

• Your domain administrator password, also avoiding special characters.

• Which optional components you would like installed. Minimally you should select Roundcube and iRedAdmin.

Now that everything has been entered, we just need to review the settings and begin the installation. After installation you will be asked if you would like to use the firewall rules provided by iRedMail. The rule will be copied to /etc/default/iptables. To use this option enter "y" and continue. You will then be shown some vital data including:

• Roundcube webmail URL.

• SOGo groupware URL.

• Web admin panel URL.

• Login username and password.

This data can also be found at /home/yourusername/iRedMail-0.9.7/iRedMail.tips.

Reboot your server.

sudo shutdown -r now

After rebooting, you can access the web admin page at https://mail.example.com/iredadmin using your domain. To access your email, use the Roundcube page at https://mail.example.com/mail. iRedMail installs the server with a self-signed certificate which requires special permissions to open the page in your browser. It is recommended that you upgrade to an official CA certificate. Let's Encrypt is a CA that offers free certificates. Visit Setup LetsEncrypt on Linux for information on using this service. Once the certificate is obtained you will need to replace the self-signed certs.

sudo cp /path/to/your/cert /etc/ssl/certs/iRedMail.crt

sudo cp /path/to/your/key /etc/ssl/private/iRedMail.key

Restart all services using the key. If you've used Nginx for your web server you would replace apache2 with nginx.

sudo systemctl restart postfix

sudo systemctl restart apache2

sudo systemctl restart dovecot