How to install Matomo manually

This article describes how to manually install the Matomo analytics platform on your A2 Hosting account.

Installing Matomo

Matomo is compatible with all A2 Hosting accounts.

To install Matomo manually, follow these steps:

1. Log in to your account using SSH, and then type the following commands:

   cd ~
   curl -O https://builds.matomo.org/matomo.zip
   cd ~/public_html
   unzip ~/matomo.zip
   

   After you run these commands, there is a ~/public_html/matomo directory that contains the Matomo application files.

2. Create a MySQL database and database user for Matomo. You will need this information during the web configuration process.
   

   • If your account includes cPanel, please see this article for information about how to create a MySQL database and user.
   • If your account does not include cPanel, you can create a MySQL database and user from the command line. For information about how to do this, please see this article.
3. Use your web browser to go to http://www.example.com/matomo, where example.com represents your domain name. The Matomo Welcome page appears.

4. Click NEXT. The System Check page appears:
   

   • On managed accounts, no additional system configuration should be required.
   • On unmanaged servers, you may have to install some additional system components to meet the software requirements.

5. Click NEXT. The Database Setup page appears:
   

   • In the Database Server text box, type localhost.
   • In the Login text box, type the name of the database user you created in step 2.
   • In the Password text box, type the password for the database user you created in step 2.
   • In the Database Name text box, type the name of the database you created in step 2.
   • In the Table Prefix text box, you can specify a table prefix for the database.
   • In the Adapter list box, select PDO\MYSQL.
6. Click NEXT. The Creating the Tables page appears. After a few seconds, you should receive a Tables created with success! message.

7. Click NEXT. The Super User page appears:
   

   • In the Super user login text box, type the administrator username that you want to use.
   • In the Password and Password (repeat) text boxes, type the administrator password that you want to use.
   • In the Email text box, type the e-mail address that you want to use with Matomo.
   • If you do not want to receive e-mail updates from Matomo, clear the email me with major Matomo community updates check box.
   • If you do not want to receive e-mail messages from Matomo about promotional offers, clear the send me information on Professional services and products for Matomo check box.

8. Click NEXT. The Setup a Website page appears:
   

   • In the Website name text box, type a descriptive name for your website. This name can be anything you want.
   • In the Website URL text box, type the URL of the website you want to track.
     You can add additional websites after installation is complete.
   • In the Website time zone list box, select your time zone.
   • In the Ecommerce list box, select Not an Ecommerce site or Ecommerce enabled.

9. Click NEXT. The Tracking code page appears:
   

   • If you use a content management system (CMS) or web application on your site, it may support Matomo integration. For more information, please visit https://matomo.org/integrate.
   • Alternatively, you can manually add the JavaScript tracking code snippet to your web site pages to enable Matomo tracking.

10. Click NEXT. The Congratulations page appears:
    

    • To change the default Matomo settings, clear the check boxes.
11. Click CONTINUE TO MATOMO. The Matomo login page appears.
12. To log in, use the administrator username and password that you specified in step 7. After you log in, the Dashboard page appears.

More Information

For more information about Matomo, please visit https://matomo.org.