Learn how to complete the Mautic Installation with PHP 7.2 on top of Ubuntu 18.04 LTS.
Quick & Dirty Mautic Installations are just for learning or testing purposes.
If you are a total newbie to the linux command line, this tutorial was made specifically for you, it's the best way to get started as I carefully designed it to have the fewer amount of commands possible, so it's easier to understand and the probability of anything going sideways is minimal. It's designed to give you a quick success using the command line so you can have an easy victory and gain confidence to later advance
There are 3 steps:
- Install the required services / components Mautic needs to run.
- Install cron jobs on the server.
- Run the Mautic configuration Wizard.
A seasoned SysAdmin can complete this tutorial in less than 5 minutes, but if you are a complete linux dummy, expect it to take you between 10 and 15 min.
This is a "Quick & Dirty" installation process, just to test Mautic, which means this process is by all means NOT to be used in a production environment with real data from real contacts.
It is tho a good enough process to install Mautic in the following cases:
- If you want to build a quick demo for showing Mautic to your boss or a customer.
- If you are a seasoned Linux command line user, this is a really fast (5 mins or less) way to bring up a test install of Mautic, for example to test the specs listed above, maybe to check if a plugin or a custom piece of code you made will run well with the latest specs.
- If you are a total newbie to the Linux command line, this tutorial was made specifically for you, it's the best way to get started as I carefully designed it to have the fewer amount of commands possible, so it's easier to understand and the probability of anything going sideways is minimal. It's designed to give you a quick success using the command line so you can have an easy victory and gain confidence to later advance by using any of my more advanced tutorials to build a production ready installation of Mautic that you can safely use with real data from your customers.
This tutorial is designed to use the root account, which is the default on Digital Ocean, but NOT on AWS or other IaaS platforms, hence if you are new to the Linux CLI or to cloud VPSs, I strongly suggest you use Digital Ocean so you can complete the tutorial without any issues. I have also chosen Digital Ocean, because you can use user/password authentication to avoid the extra steps of creating and configuring a key, which is mandatory in other providers but optional on DO.
If you don't yet have a VPS, this tutorial was made and tested using a Digital Ocean Droplet (VPS), I recommend you to use the same.
You can use this link to get $100 free credit to spend on DO servers: https://m.do.co/c/7a85b33e64cf
Before you can issue the commands specified on this guide, you will need to log into your server via SSH connection. To do so you have to use an SSH client. If your desktop/laptop runs on Linux or MacOS, you can use the "Terminal APP" already present on your system. If you are a windows user, you will need to install an SSH client like mRemoteNG:
Download mRemoteNG: https://mremoteng.org/download
How to connect to your Droplet: https://github.com/mRemoteNG/mRemoteNG/wiki/Creating-Connections
Quick and Dirty Mautic installation:
WARNING: This installation is NOT secure, use it just for testing or learning purposes.
This step by step process is based on Ubuntu 18.04 and might not work on other OSs
Let's get started!
Making sure you have the rights to issue all the commands:
Make sure our server is up to date by updating the Ubuntu installation.
apt update && apt upgrade -y
Installing all the required packages (Applications) that are needed to run Mautic.
apt install apache2 libapache2-mod-php php unzip mariadb-server php-xml php-mysql php-imap php-zip php-intl php-curl ntp -y
Activating certain Apache 2 modules that are not active by default after installation.
Downloading and uncompresing the Mautic files.
If you want to download a different version of Mautic check this link: https://mauteam.org/download-mautic
Making sure Apache and Mautic have ownership and write access to the files.
chown -R www-data:www-data /var/www/html
chmod -R 775 /var/www/html
mv 000-default.txt /etc/apache2/sites-available/000-default.conf
Creating a database for Mautic.
mysql -u root
This command will connect you to your database, the only difference you will notice is that the text before your command prompt will change to "MariaDB [(none)]>"
CREATE DATABASE mautic DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
GRANT ALL ON mautic.* TO 'root'@'localhost' IDENTIFIED BY 'password';
After the "EXIT;" command you will return to the normal mode...
Almost done, let's reload Apache configuration to apply our changes.
service apache2 reload
Install the cron jobs
Mautic is now working and you can navigate to all the sections and explore, but if you want working segments and campaigns you will also need to install the Mautic cron jobs
Done! simplest way to install cron jobs ever...
OK, so your new Mautic Installation is now completed, you just need to run the Installation wizard:
Run the Mautic Configuration Wizard
Mautic is now ready to be configured, you just need to use a browser, like Chrome or Firefox, and navigate to the IP of your server, for example, if the server was: 184.108.40.206 you would type this in your browser:
http://220.127.116.11 (Change the IP to the one of your VPS or droplet)
Here's an excerpt of your configuration for the Mautic Installation Wizard
- Database driver: MySQL PDO
- Database Host: localhost
- Database port: 3306
- DB name: Mautic
- Database Table Prefix: Leave empty
- DB User: root
- DB Password: password
- Backup existing tables: No
If you need help with the wizard steps, check this other post with step by step instructions:
Got any questions? stuck on one of the steps? anything not working as planned?
Don't hesitate to ask in the comments here below!!
You might also be interested in these other posts:
Mautic Self Hosted Best Practices.
Please Stop Using Bitnami and Cpanel to Install Mautic.
Download Mautic: Which Version to Use?
Mautic cron jobs for dummies & marketers.
Mautic Cron Jobs: Which Ones to Use.
Install Mautic Plugin for dummies.
- Last updated on .
- Hits: 354