Mailwizz Installation steps on Ubuntu 18.04

Mailwizz EMA

Introduction

Mailwizz is a fully-featured self-hosted email marketing application. Mailwizz license can be purchased from Codecanyon. This article explains the process of Mailwizz (email marketing application) installation on a Ubuntu VPS. Mailwizz can be used to run email marketing campaigns using multiple ESPs at same time. For example you can integrate Mailwizz with Sendgrid, Mailgun and PMTA at same time and a single campaign can go out from all three email streams. It has many quite unique features which an email marketer can use to improve deliverability and scale his email campaigns.

You can use it as a SAAS application and run your own email marketing company and charge your customers. It can be integrated with few payment gateways. You can create different monthly plans for your customers and can decide from backend which customer’s email campaigns go out from which email delivery servers.

System Requirement

When installing Mailwizz, the hardware (VPS) requirements are as following:

Linux Operating System
Apache Web Server – version 2.x
PHP>=7.0 (php>=7.2 for high delivery speed)
MySQL  (>=5.1) or MariaDB
Linux Cron Jobs access (not web crons)

You can purchase your VPS from Digital Ocean here or can host your VPS with any provider of your choice.

Let’s start the setup

Open the VPS terminal with root ID

Step 1: Change the hostname of the Ubuntu system:

The procedure to change the hostname on Ubuntu Linux:

  1. Type the following command to edit /etc/hostname using nano or vi text editor:
    sudo vim /etc/hostname
    Delete the old name and set up a new name.
  2. Next Edit the /etc/hosts file:
    sudo vim /etc/hosts
    From: 127.0.0.1 old-host-name To: Your-IP new-server-name-here
  3. Replace any occurrence of the existing computer name with your new one.
  4. Reboot the system to changes take effect by the command :
    sudo reboot

Step 2: Update Local Ubuntu Repositories. The add-apt-repository command is not a regular package that can be installed with apt on Debian / Ubuntu LTS

sudo apt-get install software-properties-common

sudo apt-get install software-properties-common

Step 3: Adding the PPA to your system:

sudo add-apt-repository ppa:ondrej/php

sudo add-apt-repository ppa:ondrej/php

Step 4 Update your server to the latest version:

sudo apt-get update

sudo apt-get update

The sudo apt-get update command is used to download package information from all configured sources.

Step 5. Now run :

sudo apt-get upgrade

sudo apt-get upgrade

Step 6. PHP 7.2 stable version has been released. Use the following set of commands to enable PPA for PHP 7.2 in your Ubuntu system and install it.

sudo apt-get install php7.2-xml php7.2-mbstring php7.2-gd php7.2-mysql php7.2-zip php7.2-imap curl php7.2 curl php-curl php-xml php-mysql php-mbstring php-zip apache2 mysql-server php7.2 libapache2-mod-php7.2 php7.2-cli php7.2-common php7.2-mbstring php7.2-gd php7.2-intl php7.2-xml php7.2-mysql php7.2-zip php7.2-curl

This command leads to the window of MySQL:

mysql root password

Enter the root new password carefully and hit Enter.

Note: Save all the user IDs and password very carefully.

Step 7. Now run command:

sudo mysql_secure_installation

It enables you to improve the security of your database. Enter the password and answer the question to improve security.

sudo mysql_secure_installation

Step 8. DB Creation :
Log in to MySQL by the following command and enter the mysql root password and run the following command to create a database for Mailwizz:

mysql > create database mwdb;
mysql > CREATE USER ‘mwuser’@’localhost’ IDENTIFIED BY ‘zzzip12345oop’;
mysql > GRANT ALL PRIVILEGES ON mwdb . * TO ‘mwuser’@’localhost’;
mysql > FLUSH PRIVILEGES;
mysql > exit;

mysql database creation on ubuntu

Now your database has been created with following credentials

  • Hostname: localhost
  • DB Name: mwdb
  • User: mwuser
  • Password: yourpassword

Step 9. Now run SCP command(secure copy) command to copy file(s) between your system and remote VPS in a secure way. This command is run from your home terminal.

scp /home/codecanyon-EdBgtRs-mailwizz-email-marketing-application.zip [email protected]x.xxx:/root/

Please use the file name which you have downloaded after Mailwizz license purchase.

Step 10. Now again login to your remote host.

Run ls command to confirm whether your zip file is loaded successfully or not.

scp mailwizz to vps

Step 11. Install unzip: You can use the unzip or tar command to extract (unzip) the file on Linux or Unix-like operating system. Unzip is a program to unpack, list, test, and compressed (extract) files and it may not be installed by default.

apt-get install unzip

apt-get install unzip

Now transfer the mailwizz.zip file in /var/www/mailwizz folder and unzip the Mailwizz.zip file in the same folder.
You will get a new folder called Mailwizz following by the version like mailwizz-1.8.3
In the new Mailwizz folder you have three folders
1) README.md  2) latest  3) update

Now move all the content of the latest folder to parent directory by the following command:

mv latest/* /var/www/mailwizz

Step 12. Now set up the config file of apache2. For setting up the config file of apache we need to create a file in /etc/apache2


For that create a new file like yourdomain.com.conf in “/etc/apache2”
I created filename “customers.postboxservices.conf”

apache configuration file

after that change the following lines with your domain name and your IP address.

<VirtualHost 167.71.XXX.XX(your IP address):80>
ServerAdmin [email protected]
ServerName  contacts.yourdomainname.com
ServerAlias www.contacts.yourdomainname.com
  DocumentRoot /var/www/mailwizz
ErrorLog /var/www/mailwizz/logs/error.log
CustomLog /var/www/mailwizz/logs/access.log combined
<Directory /var/www/mailwizz>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>

save and exit.

Step 13. Now switch the directory to “~#/etc/sites-enable”. And run a command

ln -s /etc/apache2/sites-available/yourdomainname.com.conf  yourdomainname.com.conf

Like

Point your browser to the install directory, i.e : http://www.yourdomain.com/install

Screen 1: Welcome

mailwizz installation completed

Your Mailwizz is ready to use. Enter the Purchase code that you get from code-canyon after purchasing the Mailwizz. and hit Next.

Screen 2: Requirements

mailwizz php modules check

As we have already installed the required PHP extensions it shows passed, hit the next.

Screen3: Database configurations

mailwizz database configuration

Enter your database details that we created in step 8: Leave the port column blank.

Hostname: localhost
DB Name: mwdb
User: mwuser
Password: yourpassword

After entering the information hit start importing. This led you to the next screen

Screen 4: Admin Account:

mailwizz backend user creation

Enter the First name, Last name, a valid email address and password
Save the password carefully as an admin you are only able to login to Mailwizz Backend window.

Screen 5: Cron jobs
Mailwizz shows a message to add cron jobs “Cron jobs – Please add the following cron jobs to your server”

mailwizz cron jobs

For this on terminal window use command crontab -e( To edit cron jobs). Select option3 to edit cron job in vi editors.

mailwizz cron jobs in ubuntu

Now copy and paste the cron jobs that are provided by Mailwizz.

Save and exit from Vi editor. Now cron jobs are installed. Continue on Mailwizz window.
The last thing you need to do is remove the install folder.
The install folder location is: “/var/www/mailwizz/install

Your Mailwizz is ready to use now. Login to the backend to set up your delivery servers and assign any new users

Login screen of mailwizz

Now your Mailwizz is ready but the indicator shows your sites is not secure to open. This is not good for any email campaign and deliverability. To make your link secure you need to install SSL certificate. For that open the terminal and follow the steps below.

mailwizz SSL certificated from letsencrypt

Step 1: First, install Let’s Encrypt client on Ubuntu.

First, add the repository:

sudo add-apt-repository ppa:certbot/certbot
sudo apt install software-properties-common

Install Certbot’s Apache package with apt:

sudo apt install python-certbot-apache

Certbot provides a variety of ways to obtain SSL certificates through plugins.
The Apache plugin will take care of reconfiguring Apache and reloading the config whenever necessary.

To use this plugin, type the following:

sudo certbot –apache -d your_domain -d www.your_domain

Example:
sudo certbot –apache -d customers.postbox.services(your domain)

While running this command agree to all the terms when prompted. It will ask if you want to redirect from http to https, always choose redirect. Once certificate is installed you will see that your Mailwizz installation works on https in the browser.

Now your Mailwizz is ready to use add your SMTP server credential and start sending email campaigns.


Author:
I am Chandan Pawar working as Team Lead (Digital marketing & SysAdmin) with Postbox Consultancy Services. I enjoy building and maintaining Linux,Unix and email servers . I have done certifications RHCSA (RedHat) and MCP (Windows) and other content and digital marketing certifications from Hubspot academy .