This is a detailed and easy to follow guide installing Mautic on your own server. Each step is outlined in detail and screenshots are provided to visually demonstrate the important steps.
1. Finding a Suitable Hosting Environment
In order to setup Mautic, you first need to have an adequate web host. This will ensure that your Mautic installation is speedy and all setup internet work-flows go without fault.
According to the Mautic website the minimum requirements for a self-hosted approach are as follows:
- PHP (minimum version 5.6.19)
- MySQL (minimum version 5.5.3)
- Apache (higher then version 2), Nginx (higher then version 1), or Microsoft IIS (higher then version 7)
For non-techies these specifics won’t matter all that much. However, their website does not specific any recommendations for how much memory or CPU power you need available for the installation. As a result, we will assume these are minimal.
Based in this information, Mautic should work on most shared hosting. Though a virtual private server would definitely make things much more snappier all around.
Personally, my favorite hosting company for practically all my web project is Web Faction. These guys basically offer shared hosting that feels more like having your own VPS. But the benefit is that you don’t have to deal with too much technical stuff.
2. Download and Extracting the Installation Files
Now that we have a place to host our Mautic, let’s begin the actual installation. This guide will demonstrate the whole process on a Web Faction hosting plan, but the principals remain universal.
Create a Place to Put the Installation
My Mautic installation is going to live in a sub directory of my website. Since the domain is already setup and the main website has a place on the web server, all that is needed is the creation of an empty sub directory.
Extract the Mautic Files Into the Directory
Next, we need to download the latest version of Mautic, which can be found on GitHub:
You can download the whole things as a zip file and then manually upload the contents on the web-server using your favorite FTP client. Or, if you are comfortable with SSH, just connect to your server and use wget to download the latest release and extract as necessary.
Now navigate to the apps folder and created a logs folder. Here are the ssh commands:
Mautic needs this as part of the installation process and will place log files here.
Now we’re ready for the actual installation.
3. Run the Guided Installation
To start the automation procedure. Navigate to the location you install Mautic using your web browser.
The Mautic installation screen, should appear. We need to click Next Step and fix any errors that might appear on the next page.
Input Database Details
Then we have a database setup screen. Here we simply input our MySQL database details we would like Mautic to use.
If you are ensure what your should put here, please first setup a new MySQL database. To do this, you will need to refer to your hosts specific instruction for creating a new database. Here is a link to the web faction database documentation:
Please note that using the default MySQL PDO database driver by produce errors. Using the MySQLi driver was the easiest solution to my errors at this step.
The recommendation here can safely be ignored.
Input Account Information – Admin
Next, we input our account information. The details here will be used for administrative purposes.
Input Account Information – Marketing
After the admin details, we are asked for more personal details. The information your provide on the last screen, is the details that will actually be used when you send your marketing emails. It’s the information that email recipients will actually see.
Forgot to take a screen of this step, so no image is provided. But it is quite straight forward.
You can use PHP Mail while your email volume is low. However, if you are sending out email to more then a thousand subscribes it is strongly recommended to use a dedicated email routing service.
SendGrid is one of the best in the area and offers a free plan for up to 12,000 monthly emails.
That’s it. If you’ve followed along, Mautic should be installed and ready to go. Now you can start planning and creating your email marketing campaigns.
If you can any questions regarding any part of this Mautic installation guide, feel free to drop a comment below. Recommendations and suggestions are always welcome as well.