Knowledge Base

How to install Piwik manually

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

If you have a shared, reseller, or managed Flex Dedicated Server account, you can use Softaculous in cPanel to guide you through the Piwik installation process. For other account types, or if you want to use the most recent version, you must install Piwik manually.

Installing Piwik

Piwik 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 Piwik manually, follow these steps:

  1. Log in to your account using SSH, and then type the following commands:
    cd ~
    curl -O
    cd ~/public_html
    unzip ~/
    After you run these commands, there is a ~/public_html/piwik directory that contains the Piwik application files.
  2. Create a MySQL database and database user for Piwik. 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, where represents your domain name. The Piwik Welcome page appears.
  4. Click Next. The System Check page appears:

    • On managed accounts, no additional system configuration should be required.
    • On semi-managed servers, you may have to install some additional system components to meet the Piwik 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 Piwik.
    • If you do not want to receive e-mail updates from Piwik, clear the email me with major Piwik community updates check box.
    • If you do not want to receive e-mail messages from Piwik about promotional offers, clear the send me information on Piwik PRO services and offers 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 Piwik integration. For more information, please visit
    • Alternatively, you can manually add the JavaScript tracking code snippet to your web site pages to enable Piwik tracking.
  10. Click Next. The Congratulations page appears:

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

More Information

For more information about Piwik, please visit