Mautic Installation – 7 Common Mistakes

Mautic can be cost-effective, has lots of powerful features, and is super extendible. Besides the fact that Mautic is arguably the best open-source marketing automation application available for professional use, there’s also a flip side.

mautic install
Mautic Installation running smoothly and error free

Many businesses and new users who’re trying to get started with Mautic quickly find out that installation, as well as keeping the application running smoothly, can be challenging. Luckily, self-hosting Mautic doesn’t have to be as difficult as most people believe.

In this article, I’ll list some of the common Mautic installation mistakes to avoid. Though I won’t go into configuration details in this post, the information should definitely help you avoid the main headaches (and possible premature gray hair)

If you’re interested to learn if Mautic is suitable for your business, have a look at the Mautic Marketing Automation Review.

Below is a list of the common Mautic installation mistakes that I see people make, over and over again. Avoid them at all costs.

1. Mautic Hosting

A common mistake is installing Mautic on shared Webhosting. This is done by using Softaculous, which is an installation script found within cPanel. Installing Mautic on shared hosting means that you’ll be sharing resources, such as CPU, storage, and bandwidth with other websites, and that you can’t administer the server yourself.

Problems

  • You get no administrative privileges on the server. This means that you’re unable to do the maintenance needed for your Mautic installation running error-free. If you’re using managed Mautic hosting, you need to be sure support is reactive and capable.
  • Slow and unreliable server performance affects Mautic features such as tracking and form submission, amongst possibly other things. You’ll need to make sure that performance is one of the main priorities of your managed Mautic hosting provider.
  • The support team doesn’t really know how to deal with Mautic issues. As a result, you can get stuck for a few days if there are problems with your Mautic installation.

Solution

If you’re looking for a good managed Mautic hosting solution, I can only recommend A2hosting for Mautic.

2. Mautic updates

When an update for Mautic is released, a notification will appear on the main dashboard of your installation. Unfortunately, using Mautic’s update button has a history of breaking the application. The result is often that you get locked out and can’t log in anymore. The automatic update button is not for the faint of heart.

Mautic update notification
An all too familiar screen

Problem

  • Updating Mautic through the button in the dashboard regularly breaks Mautic. When this happens, server administrative privileges are necessary to fix the situation.

Solution

  • Update Mautic by downloading the updated files from GitHub and manually going through the update process (through the Linux command line). This involves clearing the cache, checking the database schema, permissions to certain folders and files, and running the update from the command line.

Avoid updating Mautic through the dashboard update button. This can break your installation and lock you out of Mautic. To solve the situation, you need to log into your server and fix the issues manually. This is one of the reasons you want admin privileges to the server.

Edit (March 13, 2021): It seems that updating Mautic through the update button has been working for me lately. I have updated Mautic already a few times without any issues by just pressing the update button. This has been a problem for a long time, but it seems to be fixed (for now). I recommend, if you are planning to update Mautic, to first take a snapshot or make a backup of your installation before trying this. Better to be safe than sorry.

3. Mautic Cron jobs

Cron jobs are tasks that the operating system executes at scheduled times. Mautic needs cron jobs to function properly. Without cron jobs Mautic will not send emails, update campaign data and perform other important tasks such as database maintenance. On Linux machines, cron jobs are entered into a user’s crontab.

Problems

  • Setting the wrong paths for cron jobs. As a result, no jobs are executed
  • Stacking the cron jobs inefficiently
  • Mautic does not send emails nor does it update campaigns

Solution

  • Use absolute paths for cron jobs
  • Set the cron job at intervals that fit your project needs. It’s also best practice to keep in mind your server resources (such as the number of CPUs)

Misconfigured cron jobs are at the base of many Mautic installation problems. The most common symptom is : ‘Mautic not sending emails’.

4. Server Configurations

Both Apache, as well as Nginx, can be used for Mautic. The problem is that default server configurations are just that, namely default. For a Mautic installation to properly function to its full potential, certain configurations need to made.

Potential problems

  • Your forms not submitting at all
  • Some Mautic features, such as tracking or dynamic web content are not working
  • Negative impact overall performance in terms of speed and usability

Solution

  • Properly configure the server for CORS
  • Properly configure the server which files to serve from which locations. This can for example be done in Apache through .htaccess files, while Nginx uses locations blocks in the main server configuration files.

Both Apache and Nginx can be used with Mautic, though configuring them differs. For Mautic Features to function properly, the server needs to be configured correctly, which includes making sure that CORS (cross-reference resource sharing) is correctly set up.

5. PHP Configuration

Installing the correct PHP libraries and configuring PHP settings is important for proper functionality. For example: if you cleared the Mautic cache, due to an update you performed, the application will recreate certain folders and files upon the next login. Many default PHP configurations don’t allow enough time for this process to finish – again sending Mautic offline.

PHP LIbraries
Mautic folder permissions

Problems

  • The correct PHP libraries are not installed and Mautic doesn’t install
  • PHP times out before Mautic can finish creating the new cache folders and files
  • Not enough memory is assigned to Mautic in order to perform as it should
  • The maximum upload file size is set quite low. This will prevent uploading larger assets (if you’re planning on using your server for storage)

Solution

  • Check which libraries are installed with a phpinfo(); function.
  • If necessary, install composer and let it fetch all the required PHP libraries for you
  • Set PHP max_execution_time = 300; This increases the time that Mautic has in order to create cache folders and files.
  • Set PHP memory_limit = 256M for a 10 USD/Month server. This may vary, depending on your needs.

6. Mautic and Multiple Servers

Technically this is not a mistake, however, I recommend using a stand-alone server for your Mautic installation. The reasons for having Mautic as well as your website installed on different servers are plenty:

  • If your server goes down, your campaigns will stop. Even if your website is down for a while, you could still be sending your audience emails and marketing messages if you would have had a stand-alone server for Mautic.
  • Installing on the same server as your website impacts performance. Mautic cron jobs fire every few minutes, database storage can grow,
  • Troubleshooting is hard and solving issues can become more complex, because of shared web server settings.
  • The discrepancy in version incompatibilities between Mautic requirements and the version your website is using (see image)

The solution:

Install Mautic on its own VPS or dedicated box, so that you keep any possible issues contained to that particular server. If your website goes down or is hacked, your Mautic install is still in the safe zone. Remember, your contacts and the information in the Mautic DB is probably very valuable to your business.

7. Mautic Multiple Domains

Installing your website and Mautic on different servers is one thing, however, what domain names both are reachable at is another. Mautic uses cookies for sessions and tracking.

Third party cookie warning

The problem:

Future releases of most web browsers will deny different domains to place cookies in on the browser of a visitor. The warning (see image) is a result of Facebook (and Google) trying to place cookies (as third party), on the browser of the visitor of lexgabrees.com. This is because I have a FB pixel and Google analytics tracking code installed on my site.

This is no different than Mautic trying to track visitors because I have the Mautic tracking code installed on my site. If my Mautic installation would be under mymautic1234.com while the tracking code is installed on lexgabrees.com, then mymautic1234.com would be placing third party cookies in the browser of the visitors to lexgabrees.com.

The solution:

Install Mautic on a stand-alone server, as described earlier, yet under a subdomain of your main domain name. Now Mautic will place cookies on the browser of the visitor as the first party. This is because subdomains and top-level domains are considered as being from the ‘same-origin’.

If your website name is: thebestwordpresstheme.com, then you could install Mautic on a stand-alone VPS server, yet use the subdomain name: mautic.thebestwordpresstheme.com (or whatever your preference is).

Closing thoughts

This article does not go into the details (actual configuration of servers, PHP, Cron jobs, etc.) of installing Mautic. I wanted to avoid this post becoming some kind of ‘ultimate guide to installing Mautic on Digitalocean and Linode‘. However, I might go into more detail in a future article.

For now, I hope these guidelines will steer you in the right direction and help you avoid the headaches that many users (often unnecessarily) experience.

Edit: I recently wrote an easy-to-follow Mautic installation guide. It shows you exactly how to install Mautic on a Digitalocean Ubuntu server. If you’re interested in using Mautic self-hosted Mautic for marketing and email automation, be sure to check that article out. It goes through a relatively simple step-by-step process that will install Mautic.

If you want to learn more about Mautic and if it’s right for your business, read the Mautic Marketing Automation Review. The article dissects Mautics’s features and can give a clear picture if the application suits your business needs.

Lex Gabrees

Digital Marketing Strategist
I build cutting edge digital marketing strategies that seamlessly align with your business goals.

Get Help with Mautic

Scroll to Top

Cookies

Cookies are placed when they are necessary for the site to function properly, to show you targeted advertising messages on other sites, and to improve our service to the visitor. ‘Improve our services to the visitors’ means that we are able to assess which content is more popular so that we can focus our energy on delivering better suiting web pages to you (the reader) and serve you advertisement messages which are relevant to your interest(s) instead of showing you ads which are irrelevant to your liking.

What are cookies and why are they used?

Cookies are small pieces of text that are placed on your computer. They hold simple information for various different reasons. Cookies can be deleted anytime. There are different types of cookies, for different tools and they all have different functions. Cookies have a specific lifetime set to them. This means that after this time passes, the cookie deletes itself.

This site places cookies because the bits of information that the cookie holds make it possible  to:

  • improve the way the site works,
  • serve you better content, because it’s more relevant to your interest(s),
  • increase the site’s reach by using targeted advertising. This means that if any advertising is done through one of the mentioned partners, you might see advertising messages that are relevant to your interests, instead of irrelevant ads.

Different types of cookies and what they are used for

  1. Session cookies – these are temporary cookies that are deleted once you end your session. Session Cookies make sure that you remain recognized when you move from page to page within one site, and this way you are not required to e.g. log in.
  2. Functionality Cookies – these enable using the basic features of sites (e.g. remembering information about sites visited in order to enable ‘recalling’ them upon visitor’s request).
  3. Analytical Cookies – these provide analytical and statistical information about your site use.
  4. Targeting and Advertising Cookies – these allow measuring the effects of our advertising campaigns and personalizing advertising messages for individual users on this and other sites. Using these cookies enables us to show you advertising messages which are tailored to your interests, instead of serving you ads that are unrelated to your like(s) and interest(s).

Below you can find the list of third-party Cookies and outline of the purposes for which this site uses cookies.

You can be sure that I work with renowned and trusted vendors, who ensure a transparent approach to privacy. Such vendors have their own privacy policies with respect to the protection of Personal Data and using Cookie technology. I always recommend that you read their privacy policies so that you can understand the manner in which your personal information will be handled by these providers.

Analytical cookies

Google Analytics
Google Analytics allows us to measure and thoroughly analyze the traffic on our Site. With this information, we can make informed decisions about what content is relevant for our audience and which content is less relevant. We basically use Google Analytics to optimize the choices we make about the type of content we publish on this website.

More info:

  1. Google’s Privacy Policy
  2. Types of cookies placed
  3. Opt-Out of Google Analytics

Google Optimize
Google Optimize allows us to test our site solutions and personalize them in order to deliver engaging content to Visitors and End Users. With the Google Optimize service, we are able to test different web pages against each other and determine which of the two are more interesting to our readers (A/B split test). Based on the results we will continue adding more content to the site that is of more interest to our audience(s).

  1. Types of cookies placed

Hotjar
We use Hotjar to personalize our Site, collect your feedback and analyze site traffic. This enables us to make choices about the content we deliver. It allows us to analyze which content is most popular with our readers so that we can give them more of that type of content.

  1. HotJar privacy policy
  2. Opt-out of HotJar

Targeting and Advertising cookies

Adroll
Adroll is a service that enables us to extend our reach around the web. It allows us to make advertising messages more relevant to our audience. This means that on certain (3rd party) sites, our readers might be served relevant (and hopefully for them interesting advertisement messages), instead of non-relevant ads.

  1. Adroll Privacy Policy
  2. Opt-Out of Adroll

DoubleClick
As a Google Company, DoubleClick allows us to extend our reach while delivering relevant advertisement messages on certain (3rd party) sites to our readers. Our aim is to serve advertisement messages that are relevant to their interest(s) instead of showing irrelevant ads.

  1. DoubleClick Ad Policy
  2. Opt-Out of DoubleClick

Facebook Pixel
We have embedded a Facebook pixel on our site. This allows us to serve relevant messages across Facebook to our readers. Furthermore, it helps us make advertising messages more relevant to our audience and lets us analyze some site statistics, such as number of conversions.

  1. About the Facebook pixel

Google AdWords
We use Google Adwords, to extend the reach of our advertisement messages and campaigns. The service allows us to serve relevant advertisements to our readers as well as introduce them to our newest content.

  1. Google Adwords Ad Policy
  2. Opt-Out of Google Adwords

Opting out and removing cookies

Cookies can be removed at any time, and there are several ways of doing so. You can:

Changes to this cookie policy


The right to make changes to this cookie policy is reserved. This means that there might be changes made to this cookie policy whenever necessary. Though the policy changes will usually be minor, we do encourage our visitors to re-visit this page periodically.

For more information about cookies, you may also visit this link.