What is MailWizz?

Mailwizz is a self-hosted email marketing automation system used in building your own Email Marketing Systems.

Where to get Mailwizz?

Mailwizz is a one-time payment PHP script, so you buy it once, with no recurring payments, you can buy from here.

What do we mean by a self-hosted email marketing solution?

As I explained in my Email Marketing Definitive Technical Guide,

 any Email marketing system consists of two parts:

  • The sender: (SMTP service) this is the technical part. It allows you to send emails over the internet.
  • The Management Application, where you can configure and manage your Email Lists, Marketing Campaigns, monitor and analyze results, manage your sending servers, and so on.

So we connect both together to get an Email Marketing System.

In our case, The Management Application will be MailWizz.

In this Guide, I will show you How to setup and configure MailWizz step by step from getting a server, till running and configuring your first campaign.

MailWizz Installation

What is required to Setup MailWizz?

What you need is simply is:

  • A VPS Server to install MailWizz on.
  • Domain Name to use with our setup.

Get a Domain Name.

Getting a Domain is as simple as eating a piece of chocolate cake. you need to go to any Domain registrar company like Godaddy, Enom, Freenom, Namecheap…. and Buy a Domain Name, you can even get one for 1$ per year.

I do recommend to get a .com domain that reflects your business. and if you already have one, as I think so, you can just skip this, and continue to get a VPS Server.

Watch this 3 Minutes Video and see how to get and buy a domain name from Godaddy:

This video is part of my Top Rated Course On Udemy:
Build Your Own SMTP and Send Unlimited Emails

Get a VPS Server.

Now, Let’s get our VPS server to set up MailWizz on.

What company should I use?

You can use whatever company you want to buy a VPS Server, in this guide I will be using Digital Ocean Cloud services.

Feel free to use any VPS company you want, It’s up to you!

You can also sign up on DigitalOcean through the coupon link below to get free 100$ to test everything free.

So after you signup on Digital Ocean or any other VPS company, just create a Server with the following specifications:

  • Ubuntu 16/18 x64 as your operating system.
  • You can start with 1 CPU/ 1 GB RAM (You can resize later).

Point Domain to VPS.

Before we continue you need to point your domain or subdomain to your VPS IP address.

In my case, I will create a Subdomain “mailing.h-educate.net” and point it to my Contabo VPS IP address.

Done?
OK so now we have a Domain and a VPS server, Let’s Start the installation.

Connect to your VPS server using any SSH client like putty.

And Lets Install Apache, PHP, and MySQL which are the pre requests for hosting any PHP application like MailWizz.

*Note: In Digital Ocean or some other providers, you can get a Server with all prerequisites installed, if this is your case, you can skip all this installation and go directly to creating a MySQL Database section (part 4).

Here I’m trying to show everything so the Guide can cover any scenario.

Take a look at this video to see how I got a prebuild LAMP Droplet from Digital Ocean:

This video is part of my course:
Amazon SES: Build Your Own Email Marketing System!
Build Your Own Email Marketing System with Amazon Simple Email Service and Mailwizz EMS – 100x Cheaper!

Now, I will go back and show you how to start from scratch if you have a clean Ubuntu installation and go manually with each step.

Step 1: Install Apache2 Web Server on Ubuntu

Run the commands below to Install Apache Web Server on Our VPS Server.

sudo apt update
sudo apt install apache2

Just wait a few seconds for the installation to finish, then run the following commands to test and enable the Apache service.

sudo systemctl restart apache2.service
sudo systemctl enable apache2.service

To test if Apache is working on your Server, open any web browser and browse to the VPS IP address (http://YOUR_SERVER_IP).

You should see the Apache default page like this:

Apache default page
Apache default page

Step 2: Install MariaDB (MySQL) Database Server

MailWizz is like any other PHP System that requires a Database to save data. So we will use the MariaDB Mysql Database system for this purpose.

To install MariaDB run the commands below:

 sudo apt-get install mariadb-server mariadb-client 

The commands below can be used to stop, start and enable MariaDB MySQL service to always start up when the server boots.

Run these on Ubuntu 16.04 LTS

sudo systemctl stop mysql.service
sudo systemctl start mysql.service
sudo systemctl enable mysql.service

Run these on Ubuntu 18.04 and 18.10 LTS

sudo systemctl stop mariadb.service
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

After that, run the commands below to secure the MariaDB server by creating a root password and disallowing remote root access.

sudo mysql_secure_installation

When prompted, answer the questions below by following the guide.

  • Enter current password for root (enter for none): Just press the Enter
  • Set a root password? [Y/n]: Y
  • New password: Enter your new password (create a secure one)
  • Re-enter new password: Repeat your new password
  • Remove anonymous users? [Y/n]: Y
  • Disallow root login remotely? [Y/n]: Y
  • Remove test database and access to it? [Y/n]:  Y
  • Reload privilege tables now? [Y/n]:  Y

Restart MariaDB Mysql service

To test if MariaDB is installed, type the commands below to logon to MariaDB server

sudo mysql -u root -p

Then type the password you created above to sign on… if successful, you should see MariaDB welcome message like this:

MariaDB Installed
MariaDB Installed Successfully

Step 3: Install PHP and Related Modules

Since MailWizz is a PHP based script, we need to install PHP and some modules on our server. I will be installing PHP 7.1 in this guide, but feel free to use any version you want, just change “7.1” to “7.X” in the commands.

Run the commands below to add the below third party repository to upgrade to PHP 7.1

udo apt-get install software-properties-common
sudo add-apt-repository ppa:ondrej/php

Then update and upgrade to PHP 7.1

sudo apt update

Next, run the commands below to install PHP 7.2 and related modules.

sudo apt install php7.1 libapache2-mod-php7.1 php7.1-common php7.1-gmp php7.1-curl php7.1-intl php7.1-mbstring php7.1-xmlrpc php7.1-mysql php7.1-bcmath php7.1-gd php7.1-xml php7.1-cli php7.1-zip php7.1-imap

After installing PHP 7.1, Open WinSCP to edit the php.ini file.

WinSCP is a free Remote Visual File manager that works over SSH, it makes things a lot easier from managing and editing files with putty.

Open WinSCP and connect to your server using your server IP/Name and root credentials. Then navigate this directory: “/etc/php/7.X/apache2/” where you can find the “php.ini” configuration file.

Right-click on “php.ini” and Click Edit.

Then make the changes on the following lines below in the file and save. 

file_uploads = On
allow_url_fopen = On
short_open_tag = On
memory_limit = 256M //You can increase this if you server can handle
upload_max_filesize = 100M
max_execution_time = 360
date.timezone = America/NewYork //Set you Time Zone here

After applying the changes above, save the file and Close. then Go to Putty again and restart apache service:

 sudo systemctl restart apache2.service 

Step 4: Create MailWizz Database

Now, we are done installing all the prerequisites and our server is ready for the installation, we need to create a Database for MailWizz in MariaDB.

To login to the MariaDB MySql database server, run the commands below.

sudo mysql -u root -p

Then create a database called Mailwizz

CREATE DATABASE mailwizz;

Create a database user called MailWizz with a new password

CREATE USER 'mailwizz'@'localhost' IDENTIFIED BY 'Enter_Password_Here';

Then grant the user full access to the database.

GRANT ALL ON mailwizz.* TO 'mailwizz'@'localhost' IDENTIFIED BY 'Enter_password_here' WITH GRANT OPTION;

Finally, save your changes and exit.

FLUSH PRIVILEGES;
EXIT;

Step 5: Setup Mailwizz.

Now we are ready, you just need to upload the Mailwizz Latest Folder to the server and run the installation. So follow up the following simple steps:

1- Zip The Mailwizz “latest” Folder that you will find when you download Mailwizz.

2- Upload “latest.zip to our server” in /var/www/html using WinSCP

3- Connect to your server using Putty SSH client.

4- Change Directory to /var/www/html using the following command:

   cd /var/www/html

5- Install the unzip tool using the following command, this will be used to unzip the “latest” folder

sudo apt-get install unzip

6- Clear putty screen to make it clean using the following command:

   clear

7- Unzip the “latest.zip” file using the following command:

   unzip latest.zip

8- Using WinSCP, Move the latest folder content to the upper directory so it can be accessed directly. ( Just Drag and Drop using WinSCP )

Mailwizz Setup winscp

 Then delete the html folder, and rename “latest” to html.

 In this way, the Mailwizz files are in the html folder directly.

9- Start Mailwizz Installation by opening your web browser and opening the URL: Your_Domain/install (ex (in my case): mailing.h-educate.net/install)

Configure Mailwizz.

Now, Enter your purchase code, Agree on the terms and click Next.

Mailwizz Setup

Install PHP extensions required by Mailwizz

If you see any PHP extensions labeled in red or yellow (check image below), then you need to install it before you continue:

mailwizz php extentions

Simply run the following commands:

sudo apt install php-xml
sudo apt install php-mbstring
sudo apt install php-curl
sudo apt install php-zip
sudo apt install php-imap

Then Restart apache service using the following command:

sudo service apache2 restart

Great!

Now, click next, and Mailwizz installation will check for folder permissions, if you see any warning, then Open WinSCP and set the permission for each folder listed to 777.

mailwizz folder permessions

You can also use Putty to set permissions with the chmod command:

sudo chmod -R 777 /folderpath

After you set all permissions, refresh the page and check if everything is OK, then click Next.

In the Next Page Enter your Database info. in our case:

  • Hostname: Localhost
  • Port: 3306
  • Username: mailwizz (review step 4)
  • Password: Enter Your DB Password (review step 4)
  • Database name: mailwizz (review step 4)

Click Next and Create Your Admin Account.

Great, we are almost done! ✔️

Setup Cron Jobs

Congratulations! Now we finished the Installation process and MailWizz is up and running. we only need to set up the Cron jobs.

What are Cron Jobs?

Simply Cron Jobs are scheduled tasks that run automatically upon a schedule.

For example, if you created an email campaign that runs automatically every week. you need a task to run in the background automatically to trigger this campaign, this is the role of Cron jobs, so lets set it up.

To make things easy for you, you will just need to copy the jobs you see in the setup and past them on your server.

Where to paste them?

Open WinSCP, and in the “/etc” directory you will find the “crontab” file. Edit it, and paste the jobs inside, then save.

Important Note: when you paste the jobs add “root” to the commands so the jobs car run as root user on your VPS. Example:

* * * * root /usr/bin/php -q /var/www/html/apps/console/console.php send-campaigns >/dev/null 2>&1

Copied your cronjobs? Save the file✔️

That’s it! Enjoy MailWizz. ! 😀

Optional: Secure with a Free SSL.

SSL certificates are used within web servers to encrypt the traffic between the server and client, providing extra security for users accessing your application. Let’s Encrypt provides an easy way to obtain and install trusted certificates for free.

Connect to your Server using Putty SSH client. and Let’s Start!

Step 1 — Install the Let’s Encrypt Client

Let’s Encrypt certificates are fetched via client software running on your server. The official client is called Certbot.

First, add the repository to install Certbot:

 sudo add-apt-repository ppa:certbot/certbot 

You’ll need to press ENTER to accept.

Then, Update the package list to pick up the new repository’s package information:

 sudo apt-get update 

Install Certbot’s Apache package:

 sudo apt install python-certbot-apache 

Certbot is now ready to be used.

Step 2 — Set Up the SSL Certificate

Generating the SSL certificate for Apache using Certbot is quite straightforward. The client will automatically obtain and install a new SSL certificate that is valid for the domains provided as parameters.

Simply run the following command: (change the domain)

 sudo certbot --apache -d your_domain

You will be asked to provide an email address for lost key recovery and notices, and you will be able to choose between enabling both http and https access or forcing all requests to redirect to https. It is usually safest to require https, unless you have a specific need for unencrypted http traffic.

That’s it! ✔️

Test our website now.

Good Luck!