Piwik is a real-time web analytics application. This module configures php-fpm as backend for piwik, optionally configuring an nginx vhost as well. An automatic setup is not suported by piwik, so you need to configure piwik itself in the browser-based piwik setup.

You also need to configure a MariaDB or MySQL database and -user for piwik yourself, and enter those credentials in your browser. You can use passwordless database authentication via the UNIX_SOCKET authentication plugin with the following SQL commands: INSTALL PLUGIN unix_socket SONAME 'auth_socket'; ALTER USER root IDENTIFIED VIA unix_socket; CREATE DATABASE piwik; CREATE USER 'piwik'@'localhost' IDENTIFIED VIA unix_socket; GRANT ALL PRIVILEGES ON piwik.* TO 'piwik'@'localhost'; Then fill in piwik as database user and database name, and leave the password field blank. This works with MariaDB and MySQL. This authentication works by allowing only the piwik unix user to authenticate as piwik database (without needing a password), but no other users. For more information on passwordless login, see . Of course, you can use password based authentication as well, e.g. when the database is not on the same host.

You only need to take backups of your MySQL database and the /var/lib/piwik/config/config.ini.php file. Use a user in the piwik group or root to access the file. For more information, see .

Piwik's file integrity check will warn you. This is due to the patches necessary for NixOS, you can safely ignore this. Piwik will warn you that the JavaScript tracker is not writable. This is because it's located in the read-only nix store. You can safely ignore this, unless you need a plugin that needs JavaScript tracker access. Sending mail from piwik, e.g. for the password reset function, might not work out of the box: There's a problem with using sendmail from php-fpm that is being investigated at . If you have (or don't have) this problem as well, please report it. You can enable SMTP as method to send mail in piwik's General Settings > Mail Server Settings instead.

You can use other web servers by forwarding calls for index.php and piwik.php to the /run/phpfpm-piwik.sock fastcgi unix socket. You can use the nginx configuration in the module code as a reference to what else should be configured.