Mautic Installation: The Configuration Wizard

Mautic Installation: The Configuration Wizard

Yeah I know, this is pretty trivial, but I had made some snapshots of the process and thought, why not? Maybe someone gets stuck in one of the steps, like the database (I did the first time I installed Mautic) So here it is…

OK so after you complete the mautic installation, you have to navigate to your server or VPS, either by using the server’s IP or, if you have set up your DNS, using the domain name. After you do, and if everything went fine you will be presented with the following screens:


If you haven’t yet completed the Mautic Installation on your VPS, here’s a step by step guide for newbies and total dummies:

Mautic Installation in 7 min. with Ubuntu 18.04 and PHP 7.2

The first step is the environment check.

On the Mautic Installation – Environment Check, the script will analyze your server’s configuration and make sure that your server checks all the boxes.

Mautic Installation: Environment Check
Mautic Installation: Environment Check

If it says “Ready to Install!” you are safe to proceed, however, you can check the “Some Recommendations” to see some ways to improve your setup before proceeding.

The second step is the Database Setup.

Mautic Installation – Database Setup: This is the step most prone to give you an error or to just refuse your input; if you get an error, it’s most certainly not the script failing, it’s quite more likely that your database is not properly set up. The most common errors are related to the database being unreachable, the permissions on the MySQL server not properly configured or just the credentials (user/password) not being correct. (more common than you would think). 

Mautic Installation: Database Setup
Mautic Installation: Database Setup

In most situations you will want to use the following:

  • Database driver: MySQL PDO
  • Database Host: localhost
  • Database port: 3306
  • DB name: Mautic
  • Database Table Prefix: Leave empty (Some hosting providers will give you a prefix, otherwise leave empty)
  • DB User: root (this one might be different)
  • DB Password: password (use your password)
  • Backup existing tables: No (unless you have a previous Mautic Installation that you want to keep)

Note that if you use “Backup existing tables: Yes” Mautic will not load your old data but just back the old data and create a new database for you.

Creating your new Mautic Administrator account.

Mautic Installation – Administrative User: The user running the Mautic Configuration Wizard will be the first Administrator and will have full access rights.

Mautic Installation: Administrative User
Mautic Installation: Administrative User

You can use any Admin Username you like and it’s certainly a good idea not to use “admin” or “administrator”

Make sure your new password is secure enough. 

NOTE: Both of these parameters have nothing to do with the user and password used in the previous step.

The email address is supposed to be your personal email address and it will be used to send you internal msgs only.

Set the email address to be used by Mautic to send emails.

Mautic Installation – Email Configuration: You can use your personal email address if you want to, however, all emails going out from Mautic to your contacts will use this email address, it’s usually a good idea to use an address like mautic@yourdomain.com, marketing@yourdomain.com, news@yourdomain.com, hello@yourdomain.com, you get the idea…

Mautic Installation: Email Configuration
Mautic Installation: Email Configuration

In most cases, it is recommended to “Send immediately” your emails, but you can also configure a queue if you wish.
If you have your email provider’s credentials at hand you can now select the name of your provider, if you don’t you can do this later after you log into Mautic and you can leave this as “PHP Mail” for now.

Almost there, you just need to login!

Mautic will probably auto-populate this for you so you just have to click the login button, if it doesn’t, just manually introduce the new Administrator and Password you created just before. 

Mautic Installation: Login Screen
Mautic Installation: Login Screen

Congratulations, you did it!

If you see the screen below, you have successfully and properly configured your Mautic Instance, however, this is also a step prone to errors, if there’s some misconfiguration in your server you can get an error msg instead of the Mautic dashboard, if you do, check your Apache configuration, it’s the most probable cause for an error on this page. 

Mautic Installation: Mautic Interface
Mautic Installation: Mautic Interface

Enjoy your new Mautic setup!

If you get stuck on any step or have any questions, don’t hesitate to ask in the comments below.


Yosu Cadilla

Hi, thank you for reading this article, hope you found it useful. My name is Yosu Cadilla, I've been both a Marketer since 1996 and a Systems Administrator since 2000, switching back and forth and mixing both trades. Since discovering Mautic, I've been specializing in large Mautic deployments as well as Mautic for agencies. Nowadays all my clients are Mautic related (except just one that I've been working with since 2013). If you are planning on deploying Mautic on a large scale, or if you are undecided about Mautic being a good fit for your organization... let's have a chat! yosu.cadilla@gmail.com