Before we start we will have to make a few clarifications. For the installation and the configurations below we use two domain names, one for the mail server:
which will be used to access the mail server (mail boxes, configurations of the mail server, etc.) and one for the domain name:
which will be used for the email accounts (for example: firstname.lastname@example.org).
It is important to understand that the mail server must have a domain name which corresponds to it (in our case this is mail.example.com) but it can have multiple domain names for the email accounts (like: email@example.com, firstname.lastname@example.org, email@example.com, etc.). In our case, we will use only one domain name for the email accounts.
Feel free to change them to your own domains or sub domains, but keep in mind something very important, all domains must be registered and verified, otherwise you take the risk your server or IP address to be blocked.
Also, the domain name mail.example.com used for the mail server must be configured to point to the IP address of the machine which is going to be used as a mail server and where you will install "EasyMail". Example configuration:
All commands below must be run as root or another user with root privileges.
Install Docker if you still don't have it on your machine. For further information check Docker installation.
We will use a docker image of Ubuntu 16.04. Go to the terminal of your machine and execute the following command (read below first):
When the installation completes, attach to the container with the help of:
and go to the directory below and open the config file:
In this file, you will find the credentials which you can use to access your Web Interface, API, etc.
The configuration of the CNAME is required if we want to configure our email address with a Desktop mail client. Steps:
With the help of these CNAMES, the mail server is able to generate the following XMLs:
They are used by the desktop mail clients for automatic configuration with your mail server. You can also use the information within the XML for other manual setups.
Please take into account that we can access the XML documents through port 80 but this port may vary depending on the configurations of your web service.
It is up to you, how you will set up the SPF record but for the sake of clarity we will present a short example.
If you want to know more about how to add SPF records and the different configuration options just google for "add SPF record" or read this tutorial SPF Record.
Everyone who receives an email from an email account with domain name example.com (for example: firstname.lastname@example.org) can check the SPF record of this domain and to see that it authorizes only the server with IP address recorded in the DNS A record of the mail server mail.example.com, to send emails. If somebody else tries to send emails on behalf of example.com from a different server, this server most probably will go to the spam filters and permanently blocked.
It is a good idea to consider the configuration of the PRT record because there are SPAM filters which take this configuration into account.
“EasyMail” comes with a nice mail client “RoundCube”. In order to access it go to your web browser and type the following:
In order to log in, use the credentials from config.ini - read chapter "Install".
When you access your email account with RoundCube, you can change your password from “Settings” -> “Password”.
If you want to add new email account, declate DKIM record, add SSL certificates, etc., you can use the API.