How To Install Mautic 3 Email Marketing System [Updated Step by Step Guide)

Hasan Aboul Hasan April 10, 2020

151 Comments

What is Mautic?

Mautic is an open-source, marketing automation system and mostly used as a self-hosted email marketing solution.

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 Mautic.

In this Guide, I will show you How to setup and configure Mautic step by step.

You will also find a Video covering all the steps covered in the guide to help you see things in action.

Mautic Installation

What is required to Setup Mautic?

What you need is simply is:

A VPS Server to install Mautic 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 Mautic 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 Contabo 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.

Digital Ocean Coupon Link

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 (and 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 “mautic.xmailing.me” and point it to my Contabo VPS IP address.

Done? Great! ✔️

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 mautic.

Step 1: Install Apache2 Web Server on Ubuntu

Run the commands below to Install Apache Web Server on your 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_IP_Address).

You should see the Apache default page like this:

Installed Apache? Great! ✔️

Step 2: Install MariaDB (MySQL) Database Server

Mautic 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 (Choose between Ubuntu 16,18):

Run these on Ubuntu 16 LTS:

sudo apt-get install software-properties-common gnupg-curl

sudo apt-key adv --fetch-keys 'https://mariadb.org/mariadb_release_signing_key.asc'

sudo add-apt-repository 'deb [arch=amd64,arm64,i386,ppc64el] http://mirrors.piconets.webwerks.in/mariadb-mirror/repo/10.5/ubuntu xenial main'

sudo apt update

sudo apt-get install mariadb-server

Run these on Ubuntu 18 LTS:

sudo apt-get install software-properties-common

sudo apt-key adv --fetch-keys 'https://mariadb.org/mariadb_release_signing_key.asc'

sudo add-apt-repository 'deb [arch=amd64,arm64,ppc64el] http://mirrors.piconets.webwerks.in/mariadb-mirror/repo/10.5/ubuntu bionic main'

sudo apt update

sudo apt-get install mariadb-server

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 LTS

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

Run these on Ubuntu 18 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:

Socket password: N
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 command below to logon to MariaDB server

sudo mysql -u root -p

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

Installed DB? Great! ✔️

Step 3: Install PHP and Related Modules

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

Run the commands below to add the third party repository to install PHP 7.4

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

Then update:

sudo apt update

Next, run the commands below to install PHP 7.4 and related modules. (note: copy and paste as one command)

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

Then run the following command:

sudo apt install php7.4-pcov

After installing PHP, 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 your 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

Installed PHP? Great! ✔️

Step 4: Create Mautic Database

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

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

sudo mysql -u root -p

Then create a database called mautic (or any name you want)

CREATE DATABASE mautic;

Create a database user called mautic with a new password

CREATE USER 'mautic'@'localhost' IDENTIFIED BY 'Enter_Your_Password_Here';

Then grant the user full access to the database.

GRANT ALL ON mautic.* TO 'mautic'@'localhost' IDENTIFIED BY 'Enter_your_password_here' WITH GRANT OPTION;

Finally, save your changes and exit.

FLUSH PRIVILEGES;
EXIT;

Created a Mautic Database? Great! ✔️

Step 5: Download and Install Mautic.

To get Mautic latest release you may want to use Github repository… Install Composer, Curl, and other dependencies by running the following commands:

#First Command:
sudo apt install curl git

#Second Command:
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer --version=2.3.5

When the operation finishes, change the directory to “/var/www/html” by running the following command:

cd /var/www/html

Then Download Mautic package:

sudo git clone https://github.com/mautic/mautic.git

Now Install Mautic by running the following commands:

cd /var/www/html/mautic

sudo composer install

After the installation finishes, we need to set some file permissions by running the following commands:

sudo chown -R www-data:www-data /var/www/html/mautic/

sudo chmod -R 755 /var/www/html/mautic/

Installed Mautic? Great! ✔️

Step 6: Configure Apache2 Web Server

Well Done, Now Mautic is installed, we just need to configure apache so we can access Mautic using our domain name. To do so, open WinSCP again and navigate to this directory: /etc/apache2/sites-available/

Now, create a new empty file and name it “mautic.xmailing.me.conf” (Change to your domain)

Open mautic.conf Then copy and paste the content below into the file and save.

<VirtualHost *:80>
     ServerAdmin admin@mautic.xmailing.me
     DocumentRoot /var/www/html/mautic
     ServerName mautic.xmailing.me
     ServerAlias mautic.xmailing.me

     <Directory /var/www/html/mautic/>
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Replace with your own domain, in my case its “mautic.xmailing.me”

Enable mautic configuration in apache and restart the service.

Now simply, run the following commands to finish the setup:

sudo a2ensite mautic.xmailing.me.conf

sudo a2enmod rewrite

sudo systemctl restart apache2.service

GREAT! You are almost done????

Open your web browser now and navigate to your server name like this:

http://mautic.xmailing.me

You must see the setup completion wizard below:

Continue the setup by entering the database info and your admin login information. watch at the video at the end of this guide if you have any problems.

Done? Great! ✔️

Step 7: Configure Cron Jobs

Congratulations! Now we finished the Installation process and Mautic 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.

Mautic has several Cron Jobs, some are required and some are optional, check a list of all Mautic Cron jobs here.

To make things easy for you, you will just need to copy the jobs below and paste them on your server.

#Segments Every 2 Minutes
*/2 * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:segments:update
*/3 * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:import

#Campaigns (Every 1 Minute)
* * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:campaigns:update
* * * * * root /usr/bin/php /var/www/html/mautic/bin/console
mautic:campaigns:trigger
* * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:messages:send

#Process Email Queue Every 5 Minutes
*/5 * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:emails:send
#Fetch and Process Monitored Email Every 10 Minutes
*/10 * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:email:fetch


#Process Email Queue Every 5 Minutes
*/5 * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:emails:send

#Fetch and Process Monitored Email Every 10 Minutes
*/10 * * * * root /usr/bin/php /var/www/html/mautic/bin/console mautic:email:fetch

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.

Check If Cronjobs Are Correctly Configured.

After you paste and save the cronjobs (each on one line and add a new empty line after the last one), It's a good practice to test if the file syntax is correct.

You can do this my simply running the following command in putty:

crontab /etc/crontab

If the output was empty (nothing) then everything is ok!

That's it! Enjoy Mautic.

Mautic Installation Video:

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 mautic.xmailing.me

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, for me, I will open “https://mautic.xmailing.me”

Good Luck!

Categories: Email Marketing

Tags: EMS, mautic

Free SMTP Server Setup with Postal (Step by Step Guide)

In this Step by Step Guide, I will show you how to set up a Free SMTP server using Postal, the open source SMTP software,…

Hasan Aboul Hasan April 15, 2020

191 Comments

How to Install MailWizz Email Marketing System (Step by Step Guide)

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…

Hasan Aboul Hasan April 11, 2020

22 Comments

PowerMTA Setup Guide

When it comes to setting up an SMTP Server for your Business, we have different choices and methods to build it. One of these methods…

Hasan Aboul Hasan March 10, 2020

28 Comments

How to Setup SMTP Server and Send Unlimited Emails! (Step by Step Guide)

In this Step by Step Guide, I will show you how to setup an SMTP server and connect it to your email marketing applicaiton to…

Hasan Aboul Hasan April 14, 2020

52 Comments

How to Publish PHP Website (Install CodeCanyon Scripts)

In case you bought a PHP script from Codecanyon and you want to install it, or maybe you are a PHP developer, and you want…

Hasan Aboul Hasan November 26, 2020