How to install Matomo manually
This article describes how to manually install the Matomo analytics platform on your A2 Hosting account.
- If you have a shared, reseller, managed VPS, or managed dedicated server account, you can use Softaculous in cPanel to guide you through the Matomo installation process. For other account types, or if you want to use the most recent version, you must install Matomo manually.
- Matomo was formerly known as Piwik.
Matomo is compatible with all A2 Hosting accounts.
Although A2 Hosting servers are compatible with a wide variety of software applications, we cannot provide troubleshooting assistance for application-specific issues.
To install Matomo manually, follow these steps:
- Log in to your account using SSH, and then type the following commands:
curl -O https://builds.matomo.org/matomo.zip
After you run these commands, there is a ~/public_html/matomo directory that contains the Matomo application files.
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.
- Use your web browser to go to http://www.example.com/matomo, where example.com represents your domain name. The Matomo Welcome page appears.
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.
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.
- Click NEXT. The Creating the Tables page appears. After a few seconds, you should receive a Tables created with success! message.
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.
Click NEXT. The Setup a Website page appears:
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.
Click NEXT. The Congratulations page appears:
- To change the default Matomo settings, clear the check boxes.
- Click CONTINUE TO MATOMO. The Matomo login page appears.
- To log in, use the administrator username and password that you specified in step 7. After you log in, the Dashboard page appears.
For more information about Matomo, please visit https://matomo.org.