Recommendations

For best results is recommended the installation of Remmina Remote Desktop Client. If you are about to install VirtualMailServer on local host and you are not using a DNS server, don't forget to add to your /etc/hosts the local ip address of the machine where VirtualMailServer in installed on followed by the Postfix FQDN provided by you during the installation. This both on clients and server side. Do the same in the case you are going to install Roundcube.

Preparations:

Local Host:

Open a terminal and digit sudo su followed by your password. Go to the folder where VirtualMailServer has been downloaded, decompress the file using the command tar xvfz VirtualMailServer_Latest.tar.gz and move the folder to /root using the command cp -R VirtualMailServer /root. Enter VirtualMailServer directory digiting cd /root/VirtualMailServer and digit ./virtualmailserver. The script will start to download all what the system needs for the proper functioning of VirtualMailServer. Once done, you will be prompt to the VirtualMailServer main installation screen.

Ubuntu VPS:

In this case /root will be directly your Home, so you won't need to move the decompressed folder. Just decompress the tar file, enter VirtualMailServer directory with the commands provided above and digit ./virtualmailserver and wait for the installation of the extra components VirtualMailServer needs for the proper functioning of the script. Once done, you will be prompt to the VirtualMailServer main installation screen.

Installation:

Press OK button to procede with the installation

Choose Local by pressing the spacebar in the case you are going to install VirtualMailServer on local host or Public in the case of an Ubuntu VPS installation. Press OK button to procede.

Digit your Fully Qualified domain Name (FQDN) for Postfix ( for example mail.yourdomain.com or postfix.yourdomain.com). The same FQDN will be automatically used to have access to your Postfix Admin web interface. Don't forget to add the A record to your personal DNS server or the one provided by your registrar. Press OK button to procede.

In the case you are installing VirtualMailServer on a Ubuntu VPS, you will be asked to enter an email address to which notifications regarding the certificate obtained through Let's Encrypt will be sent to. In the case you are installing VirtualMailServer on local host, the cert will be automatically created by the system.

Digit your Domain name ( yourdomain.com ). Press OK button to procede.

Digit your Postfix database name ( whatever you want ). Press OK button to procede.

Digit your Postfix database username ( whatever you want ). Press OK button to procede.

Digit your Postfix database password ( whatever you want ). Press OK button to procede.

Digit your MySQL root password ( the password you inserted for two times during the installation process of the extra components in the case MySQL was not already installed on your system ). Press OK button to procede with the installation.

All done. You should be prompted to your VirtualMailServer control panel. Now, if you want to use a secure https connection, scroll down using the down arrow, enter the menu Enable/disable https and choose En/dis https for Postfix Admin

Usage:

Postfix Admin

Connect to Postfix Admin web interface by digiting the address provided by VirtualMailServer interface in your browser.

During VirtualMailServer installation a default account for administrative use has been automatically created. Log in to Postfix Admin using the default user created admin@example.com and password admin1234.

Now, for obvious security reasons, you must create a new account. Choose from the top menu Admin List and in the following screen Add Admin.

Insert your new email address for administrative use followed by your new password and don't forget to tick the checkbox marked with the number 4 in the picture above. Now, add your new admin account by pressing Add Admin. After that, go back to your Admin List and delete the default account created during VirtualMailServer installation process. Log out and log in with your new administrative account.

Now, in the main menu select Virtual List > Add Mailbox to add your first mailbox.

Fill-out the fields regarding your username ( don't write the domain, just the username ) and password. The fields for your full name and quota are optional. If you leave empty the field regarding the quota, the quota for the user will be without limits. Press Add Mailbox to create your first mailbox.

The very basic configuration for Postfix Admin ends here. Really easy,isn't it?

Roundcube