Required Configuration to Run Matomo

To run Matomo (Piwik) your host needs a couple of things:

  • Webserver such as Apache, Nginx, IIS, etc.
  • PHP version 5.5.9 or greater
  • MySQL version 5.5 or greater, or MariaDB
  • (enabled by default) PHP extension pdo and pdo_mysql, or the mysqli extension.

We recommend using PHP 7 as it is more memory efficient and faster than previous PHP versions.

We recommend using MySQL 5.7+ or MariaDB for your database.

To make the most out of Matomo (Piwik), you also need a few extra PHP extensions such as the PHP GD extension that is used to generate the sparklines (small graphs), graphs in statistics Email reports, as well as graphs in the Matomo Mobile App. The list of PHP extensions you are recommended to install are:

$ sudo apt-get install php7.0 php7.0-curl php7.0-gd php7.0-cli mysql-server php7.0-mysql php-xml php7.0-mbstring

For medium and high traffic websites, please see the following FAQ for more information: Matomo (Piwik) setup for high traffic websites

MySQL User requirements

When installing Matomo (Piwik), you will need to specify a MySQL username and password. The MySQL user must have permission to create and alter tables in the database.

The MySQL USER should have the permission to SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES, FILE.

Click here for detailed instructions on how to create a new database and MySQL user.

If you do not have a server with PHP 7 enabled, we have created our own high quality Matomo (Piwik) hosting service providing a pre-installed Matomo for a small fee. See our Matomo page for more information.

Next step is to Install Matomo (Piwik).