Installing Matomo

Installing Matomo



1.Getting Started

Before you get started, ensure that you have the following:

  • A web server, shared hosting or dedicated server. If you do not have a web server or shared host to install Matomo on, you can get a pre-installed Matomo in minutes. Try the Matomo Cloud (formerly Piwik Cloud) service created by the makers of Matomo themselves.
  • Access to your web server (via shell or FTP)
  • If you have a WordPress website, we now have an easier and faster option for you to get the Matomo Analytics for WordPress plugin
  • A FTP Client (if you are installing Matomo on a remote server)

2.Check you meet the minimum requirements

Check to make sure that your web host meets the minimum requirements to run Matomo.

3.Download Matomo

Download the latest release Matomo 4.4.1 from here:

 >> Download Matomo for free

Using WordPress? Try Matomo Analytics for WordPress! No technical setup required.

>> Install Matomo for WordPress.

4.Start the Installation

If your web host offers one-click software (Softaculous or Installatron for example), you can Install Matomo in one click.

Otherwise, follow these steps:

  • Unzip the zip file to a folder on your hard drive. This will create a “matomo” folder containing the files and directories.
  • Open your FTP client and upload the Matomo files in ‘binary mode’ to the desired location on your web server. For example using the Filezilla FTP client, you can enable Binary mode transfer in the top menu Transfer > Transfer type > Binary). All files can be uploaded to a “analytics” sub-directory in your public www folder, for example or you could setup Matomo in its own subdomain and upload all the files at

If you have SSH access to your server, you can use it instead of FTP as it is much faster: run

wget && unzip

When Matomo is uploaded you can move on to the next step!

5.The 5-minute Matomo Installation

Open your web browser and navigate to the URL to which you uploaded Matomo. If everything is uploaded correctly, you should see the Matomo Installation Welcome Screen. (If you are not seeing the Welcome screen, also check that your web server such as Apache or Nginx or IIS is configured and working). If there are any problems during the installation, Matomo will identify them and help you out with a solution.

The Welcome Screen

Time to get started with the point-and-click installation! Click Next »

System Check

Matomo will check to make sure that your server meets the Matomo requirements. If everything is okay, you’ll see a long list like this:

If there is a problem, Matomo will identify it and tell you how to solve it, as in this example:

When all the requirements are met, click Next »

MySQL Database Setup

You should already have set up your MySQL database. If you do not have the database information, you may need to ask your web host or technical staff.

Security note: for added security, we recommend that you install Matomo in its own MySQL database and specify a username and password for a user that only has access to that database. Click here to see detailed instructions on how to create a new database and MySQL user.

(Note that by default the port 3306 is used when connecting to the database. If your server uses a different port you can enter it after the hostname, for example localhost:3307)

Once you have filled in the form, click Next »

Matomo will add the necessary tables to your database:

Click Next »

Super User

The super user is the user that you create when you install Matomo. This user has the highest permissions. Choose your username and password:

Do not lose this information; it is the only way for you to log in to Matomo for the first time. There is only one super user in each Matomo installation. The super user can perform administrative tasks such as adding new websites to monitor, adding users, changing user permissions, and enabling and disabling plugins.

By default the super user will be signed up for upgrade and security alerts, as well as for community updates. Uncheck these boxes if you do not want to receive these emails.

Fill in the information and click Next »

Set up Your First Website

Enter the name and URL of the first website you want to track. You can add more websites once the installation is complete.

Click Next »

Install the JavaScript Tracking Tag

Matomo will issue you with a JavaScript tag. This code must appear on every page that you want Matomo to analyze. We recommend that you paste this code immediately before your closing </head> tag (or in a general header file that is included at the top of all your pages).

If you use a CMS such as WordPress, Drupal or Joomla!, you can use an add-on, extension or plugin to make sure this tag appears where it needs to.

Otherwise you will need to insert your tracking tag manually.

When you have copied your tracking tag click Next »


Matomo is installed and ready to track your visitors. As soon as visitors start arriving, Matomo will be keeping track of their data. Matomo reports are generated in real time, so you should see data in your Matomo dashboard straight away.


Click Continue to Matomo » and log in to your dashboard!

If something isn’t working correctly or you are experiencing an error, you may want to take a look at the Troubleshooting Guide.

6.Configuring Matomo

If the Matomo JavaScript tracking tag is properly installed on your website, you’ll be receiving real time analytics data. If you are not receiving any data, make sure that you have copied and pasted the Matomo Javascript code to your website’s pages.

If you want to give other users access to Matomo, or monitor more than one website, or rebrand Matomo or install third party plugins, you will need to use the Administration pages. Click “Administration” in the top menu, then click “Users” to manage users and permissions.

When you have finished configuring Matomo, you can set more restrictive permissions (ie. read only) to the “matomo/config/” folder. There are only two places where Matomo will need to write files:

  1. the matomo/tmp/ folder
  2. the matomo/js/piwik.js and matomo/js/matomo.js files

7.Medium and High-Traffic Websites: Setup an automated task (cron) to process reports

If your website is a medium or high-traffic website (more than a few hundred visits per day), we highly recommend to set up auto-archiving cron task so that Matomo calculates your reports periodically. When the cron is setup and the timeout value increased, Matomo dashboard will load very quickly as the reports will be pre-processed by the core:archive command triggered by cron.

If you do not setup the cron, Matomo will recalculate your statistics every time you visit a Matomo report, which will slow Matomo down and increase the load on your database.

Instructions for setting up auto-archiving can be found on the Matomo website at How to setup Matomo auto-archiving.

Updates, Recommended Server Configuration, and More

Check also the Matomo Installation, Update & Optimization documentation for more information.

Matomo training videos

Want to get an overview on how to use Matomo? Watch these training videos below!

Matomo’s functions


  • Import/Export Feature – Matomo Analytics gives you the opportunity to import your Google Analytics reports. In addition, you can export your Matomo Analytics report with just one click.
  • Comparative report
  • Support WP REST API and other APIs
  • Easily include specific user, visitor and page roles so they won’t be crawled
  • Give your colleagues access to your reports
  • Support for WP Multisite

Also, let us install Matomo Analytics. This is a free plugin available at, so you know it will be easy.

Navigate to Plugins > Add New :

Then type “Matomo Analytics” in the keyword search box and when you find the plugin hit the Install Now button, as shown below.

Then activate the plugin:

By activating the plugin, a Matomo Analytics entry is added to your WordPress admin panel. Then go to Matomo Analytics > Get Started , as we highlight below.

On the Start Screen, you get a lot of information. Then click the Allow Tracking Now button, as shown below.

As seen on the previous page, you can add (matomo_option) Shortcode to their privacy policy page so users can opt out of tracking.

In addition, you can choose to never show the Start page more and learn more about Matomo Analytics. On the same page, you can easily find help through user guides, forums, various premium support packages and more.


After clicking the Allow Tracking Now button, Matomo Analytics is ready to go. Now let’s look at some of the available options.

I went ahead and sent some simulated traffic to my test site with a bot, you know, just to check if the plugin works as advertised, and guess what? It works! It logs both my bot and instance traffic when I visit the sample site. Here is the screenshot:

To access the previous page, navigate to Matomo Analytics > Reports , as shown below.

To access the Matomo Analytics Tag Manager (so you can add third-party tracking codes), navigate to Mamoto Analytics > Tag Manager , as we highlight below.

Doing so will take you to the next page:

On the previous page, you can create labels like we did in a previous article. Procedure remains the same.

To access Matomo Analytics settings, navigate to Matomo Analytics > Configuration , as detailed below.


Matomo Marketplace allows you to install a ton of free and premium add-ons, so you can take your Matomo to the next level:

To install the Matomo plugin in your WordPress admin, you must first install the Matomo Marketplace plugin for WordPress.

How? Navigate to Matomo Analytics > Markets and click on the Download Matomo Marketplace for WordPress button as shown below.

Save the Matomo Marketplace plugin on your computer.

Then navigate to Plugins > Add New :

Next, click on the loading plugin, select the Matomo Marketplace plugin you downloaded, and hit the Install Now button:

Then click to activate Matomo Marketplace. Once the Matomo Marketplace WordPress plugin is up and running, you’re ready to party. Let’s start with the free plugins.


Installing the free Matomo Analytics plugin is very easy. Navigate to Matomo Analytics > Markets and click on the Plugins Settings tab:

Just tap the Install link next to the respective plugin (see image above). Matomo Analytics offers a total of 66 free plugins at the time of writing.


To install premium plug-ins, you must first activate your Matomo Analytics license. First log in to your Matomo Analytics account and click Download:

Scroll to the bottom of the screen and select Click to show your license link:

Remember to copy your license key because we need it for the next part.

Return to your WordPress admin panel. Navigate to Matomo Analytics > Markets and click on Register Blades. Then paste your license and click the Save license key button:

After successfully activating the license, Matomo Analytics will redirect you to the Plugin Settings tab, where you will find free and premium plugins.

Then just tap the Install link under the premium plugin you want to install. In this session, Matomo offers nine premium plugins.

I went ahead and tried the premium plugins. Below you will find brief descriptions of what each premium plugin does.


Source: Cohort: Matomo

You always want visitors to come back to your site for more great content and products. More importantly, you want your visitors to stay, because the more they do, the more impact they will have and the more money they will earn.

The Matomo Analytics Cohorts plugin helps you track your visitor retention efforts over time, so you can keep them interested and coming back for more. It allows you to see how your web visitors behave on and after your purchase date. In other words, Cohorts helps you:

  • See how long new visitors stay before leaving your site.
  • See the specific time period where the engagement falls
  • Understand why some visitors to your store don’t buy even after multiple visits
  • Identify your application usage and
  • Overall, track your retention efforts


You have a business goal and need, which is to track your traffic. We start by saying right Traffic is the lifeblood of any website and to define your target audience it is important to get actionable metrics and information. With the right information, you can eliminate friction in the buying process by tweaking your app or website.

Now Matomo Analytics is a powerful tool that provides you with a great set of standard reports. However, as with any other tool, important information can be lost. In the past, you had to give up information or create spreadsheets manually, which was time-consuming and error-prone.

But Matomo is changing all that with Custom Reports, a premium plugin that lets you extract as much information as you want from your traffic. You have over 200 different metrics to get exactly the information you need. Yes, 200, plus you can customize your reports extensively with visualizations and filters.


I bet my money has at least one form somewhere on your website or web app. Forms can range from comment forms, order forms, subscriptions to newsletters, contact forms, job postings, etc. And why is shape important? Yes, it’s true, it’s an important point of contact with your visitors and potential customers.

Now, would you like to have a better idea of ​​how your customers and readers interact with your forms? Think about what you can achieve with all that data. You’ll learn about your customers’ weaknesses and how they interact with your online forms. You can even track form conversions and do much more. All thanks to Forms Analytics.


Let’s say you want potential customers to come to your homepage, click the “Contact Us” button, fill out your contact form, and hit the Submit button. Then you might want to redirect the potential customer to a thank you page, blog, or whatever. Every action a potential customer takes to contact you is part of the funnel.

To work with you, you need visitors to follow a predefined “route” on your website or app. Your job is to direct visitors from the target entry point. And to get the most out of this “route,” you must fully understand how visitors move through your funnel.

Here’s a great video from Matomo detailing how the channel works:



Source: Click Heatmap: Matomo

Matomo Analytics is a gift that never stops giving. With the premium Heatmap & Recording Session plugin, you can “…really understand your visitors by seeing where they click, scroll, and scroll”. It’s like eye tracking but cheaper and easier to set up.

Heatmaps show you where visitors clicked, how far they traveled, and where they moved their mouse. All this data helps in knowing if your content is engaging and determining where users are paying attention.

Session recording, on the other hand, allows you to record scrolls, mouse movements, clicks, form interactions, etc. Then play the video to see what visitors are doing on your site. How sweet?


Video usage has grown tremendously with many marketers looking to increase traffic, page views, conversions, and ultimately sales. The same goes for audio, such as podcasts, audiobooks, etc. And multimedia doesn’t go anywhere.

But do you know how your audience views your videos? How do you hear the sound? Can you explicitly establish the connection between media usage and other traffic metrics? Who watches your videos? In how long? These are just some of the questions that the Media Analytics plugin helps you answer.


For a website or application, traffic can come from many different sources. Maybe it will generate traffic from Google Ads, Facebook Ads, organic search and social references. How do you know which traffic sources generate the most results in terms of conversions, among other metrics?

It is important that you know where to direct your marketing budget. If organic search gives you quality traffic, you’ll better redirect resources to what’s working, for example, SEO. Now you don’t have to wonder which traffic source is getting better. It has Matomo’s multi-channel conversion property according to your entire processing.


One keyword: the holy grail of search engine traffic. What will you do to get your hands on all the keywords your customers use in Google and Bing, among others? By knowing your keywords, you can create content that is relevant and highly targeted and delivers that work like magic. It has been done many times before, and so can you.

The Performance Engine Keyword Performance plugin shows you all the keywords your potential customers use. You can view popular search engines, text keywords, match keywords, image keywords, and video keywords. The plugin allows you to see the needs of your target audience in one place.

Buy us some coffee

Thank You for your support as we work to give you the best of guides and articles.