Matomo

From Alpine Linux

Matomo s a real time web analytics software program. It provides you with detailed reports on your website visitors: the search engines and keywords they used, the language they speak, your popular pages, and more.

Warning: Piwik was renamed to Matomo in January 2019, the file paths below may need to be updated.


Install lighttpd, PHP, and MySql

Basic Installation

For installing the additional packages first activate community packages and update the package index

Install the required packages:

# apk add lighttpd php82 fcgi php82-cgi

Configure Lighttpd

Edit lighttpd.conf (/etc/lighttpd/lighttpd.conf) and uncomment the line:

Contents of /etc/lighttpd/lighttpd.conf

... include "mod_fastcgi.conf" ...

Edit mod_fastcgi.conf (/etc/lighttpd/mod_fastcgi.conf), find and change /usr/bin/php-cgi to /usr/bin/php-cgi82.

Contents of /etc/lighttpd/mod_fastcgi.conf

... "bin-path" => "/usr/bin/php-cgi82" # php-cgi ...

Start lighttpd service and add it to default runlevel

# rc-service lighttpd start # rc-update add lighttpd default

Install extra packages:

apk add php-mysql mysql mysql-client

Installing and configuring Matomo

Matomo needs some additional packages

apk add php-zlib php-pdo_mysql

Create the a folder named webapps

mkdir -p /usr/share/webapps/

Download the source code

cd /usr/share/webapps/ wget https://builds.matomo.org/matomo-latest.zip

Unpack the archive and remove it afterwards

unzip latest.zip rm How\ to\ install\ Piwik.html latest.zip

Change the folder permissions

chmod -R 777 /usr/share/webapps/

Make a symlinks to the piwik folder

ln -s /usr/share/webapps/piwik/ /var/www/localhost/htdocs/piwik

Configuration and start MySql

/usr/bin/mysql_install_db --user=mysql rc-service mysql start && rc-update add mysql default /usr/bin/mysqladmin -u root password 'password'

Configuration of Piwik

Browse to http://WEBSERVER_IP_ADDRESS/piwik/ and the configuration process will start.

Upgrading Piwik

It's still possible to upgrade Piwik by replace the old files with new ones. But a faster way is to use the integrated upgrade mechanism of Piwik itself. Just follow the instructions mentioned in the web interface.