Matomo — Self-Hosted Google Analytics Alternative

What it is

Matomo (formerly Piwik) is an open-source web analytics platform that you host on your own infrastructure. It tracks page views, visitor flows, referrers, e-commerce conversions, and campaign attribution while keeping all data under your control. Unlike cloud analytics services, Matomo stores everything on your servers.

Matomo is built for website operators who need analytics without sending visitor data to third parties. It suits teams subject to GDPR, CCPA, or PECR regulations, as well as organizations that simply prefer data sovereignty.

How it saves time or tokens

This TokRepo workflow provides a ready-to-run Docker configuration for Matomo. Instead of reading through installation docs and configuring PHP, MySQL, and cron jobs manually, you get a single docker-run command that launches a working instance. The included cron-based archiver setup automates report pre-processing, so dashboards load instantly rather than computing on every request.

How to use

1. Run the Docker container with your database credentials:

docker run -d --name matomo -p 8080:80 \
  -v matomo-data:/var/www/html \
  -e MATOMO_DATABASE_HOST=db \
  matomo:latest

1. Open http://localhost:8080 and complete the web installer. Connect your MySQL or MariaDB instance, create an admin account, and add your first website.

1. Add the Matomo JavaScript tracking snippet to your site. The installer generates the snippet automatically. Paste it before </body> on every page you want to track.

1. Set up the cron archiver to pre-process reports:

*/5 * * * * /usr/bin/php /var/www/html/console core:archive \
  --url=http://localhost:8080 > /dev/null 2>&1

Example

# docker-compose.yml for Matomo + MariaDB
version: '3'
services:
  db:
    image: mariadb:10.11
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: matomo
    volumes:
      - db-data:/var/lib/mysql
  matomo:
    image: matomo:latest
    ports:
      - '8080:80'
    environment:
      MATOMO_DATABASE_HOST: db
      MATOMO_DATABASE_USERNAME: root
      MATOMO_DATABASE_PASSWORD: secret
      MATOMO_DATABASE_DBNAME: matomo
    volumes:
      - matomo-data:/var/www/html
    depends_on:
      - db
volumes:
  db-data:
  matomo-data:

Related on TokRepo

• Self-hosted tools -- Browse other self-hosted platforms for AI and developer workflows
• Monitoring tools -- Explore observability and monitoring solutions that complement analytics

Common pitfalls

• Forgetting to set up the cron archiver leads to slow dashboard loads because Matomo computes reports on every page view instead of pre-processing them.
• Running Matomo on shared hosting with limited PHP memory causes archiving failures. Allocate at least 256MB for the archiver process.
• Not configuring a reverse proxy with HTTPS means tracking requests are sent in plain text, which defeats the privacy purpose.