STATUS ÜBERPRÜFEN
I AM LISTENING TO
|

Day 33: Matomo – Leading Open-Source Web Analytics Platform – 7 Days of Docker

9. Juli 2025
.SHARE

Table of Contents

What is Matomo?

Matomo (formerly known as Piwik) is a leading open-source web analytics platform that provides a privacy-focused alternative to Google Analytics. It gives you complete control over your data while offering comprehensive website analytics capabilities.

Key Features:

  • 100% Data Ownership: All data stays on your servers
  • Privacy Protection: GDPR-compliant with advanced privacy controls
  • Real-time Analytics: Live visitor tracking and behavior analysis
  • E-commerce Tracking: Advanced online business analytics
  • Goal & Campaign Tracking: Conversion optimization tools
  • Custom Variables & Segments: Flexible data analysis
  • Geolocation & Maps: Real-time visitor location tracking
  • Email Reports: Automated analytics delivery
  • Extensible Platform: Plugin system for customization

Docker Installation Options

There are two main Docker approaches for installing Matomo:

  1. Official Matomo Docker Image – Maintained by the Matomo team
  2. Bitnami Matomo Image – Enterprise-grade image by VMware

Prerequisites

Before starting, ensure you have:

  • Docker Engine >= 1.10.0
  • Docker Compose >= 1.6.0
  • At least 2GB RAM available
  • 10GB+ disk space for data storage

Check your Docker installation:

Method 1: Official Matomo Docker Image

Basic Docker Compose Setup

Create a project directory and docker-compose.yml:

Production-Ready Configuration with Nginx

For production deployment with SSL support:

Method 2: Bitnami Matomo Docker Image

Basic Bitnami Setup

The Bitnami image provides enterprise-grade security and stability:

Enhanced Bitnami Configuration

For production with additional security and performance features:

Installation Steps

1. Create Project Directory

2. Choose and Create Docker Compose File

Copy one of the configurations above into a docker-compose.yml file.

3. Configure Environment Variables

Create a .env file for sensitive data:

4. Start Services

5. Access Matomo

Initial Configuration

Database Setup (Official Image)

When accessing Matomo for the first time, use these database settings:

  • Database Server: db (or mariadb for Bitnami)
  • Username: matomo
  • Password: matomo_password (your configured password)
  • Database Name: matomo
  • Table Prefix: matomo_
  • Adapter: PDO\MYSQL

Bitnami Auto-Configuration

The Bitnami image automatically configures the database connection using environment variables, so you can skip the database setup step.

Security Best Practices

1. Change Default Passwords

Never use default passwords in production:

2. Configure Trusted Hosts

Edit the Matomo configuration to add trusted hosts:

3. Use SSL/TLS

Always use HTTPS in production:

  • Configure SSL certificates
  • Set up proper nginx configuration
  • Use Let’s Encrypt for free certificates

4. Regular Backups

Set up automated backups:

Maintenance Commands

Update Matomo

Database Maintenance

Log Management

Performance Optimization

1. Database Optimization

2. Caching Configuration

Enable caching in Matomo:

3. Archive Processing

Set up automated archiving:

Environment Variables Reference

Official Matomo Image

  • MATOMO_DATABASE_HOST: Database hostname
  • MATOMO_DATABASE_ADAPTER: Database adapter (mysql)
  • MATOMO_DATABASE_TABLES_PREFIX: Table prefix
  • MATOMO_DATABASE_USERNAME: Database username
  • MATOMO_DATABASE_PASSWORD: Database password
  • MATOMO_DATABASE_DBNAME: Database name
  • PHP_MEMORY_LIMIT: PHP memory limit

Bitnami Image

  • MATOMO_DATABASE_HOST: Database hostname
  • MATOMO_DATABASE_PORT_NUMBER: Database port
  • MATOMO_DATABASE_USER: Database username
  • MATOMO_DATABASE_PASSWORD: Database password
  • MATOMO_DATABASE_NAME: Database name
  • MATOMO_USERNAME: Admin username
  • MATOMO_PASSWORD: Admin password
  • MATOMO_EMAIL: Admin email
  • MATOMO_HOST: Domain name
  • MATOMO_SKIP_BOOTSTRAP: Skip initial setup

Production Deployment Checklist

  • Use strong passwords for all services
  • Configure SSL/TLS certificates
  • Set up proper firewall rules
  • Configure trusted hosts
  • Set up automated backups
  • Configure monitoring and alerting
  • Set up log rotation
  • Configure automated archiving
  • Test disaster recovery procedures
  • Document configuration and procedures

Useful Resources

Thoughts

Both the official Matomo Docker image and Bitnami’s version provide excellent options for deploying Matomo. The official image offers more flexibility and direct access to Matomo features, while Bitnami provides enterprise-grade security and easier configuration management.

Choose the approach that best fits your needs:

  • Official image: For maximum flexibility and customization
  • Bitnami image: For enterprise environments requiring enhanced security

Remember to follow security best practices, set up proper monitoring, and maintain regular backups for production deployments.

FAQ

What is Matomo and how does it differ from Google Analytics?

Matomo is an open-source, privacy-focused web analytics platform that gives you 100% data ownership. Unlike Google Analytics, Matomo doesn’t share your data with third parties, is GDPR compliant by design, and allows you to host your data on your own servers or in the EU. You get complete control over your analytics data without compromising visitor privacy.

What are the differences between Matomo Cloud and On-Premise?

Matomo Cloud: Hosted by Matomo, includes all premium features, automatic updates, and support. Pricing starts at $23/month for 50,000 hits. Data stored in Frankfurt, Germany.

Matomo On-Premise: Self-hosted on your servers, free core software, you manage updates and maintenance. Premium features cost extra. Complete control over data location and security.

What are the minimum requirements to run Matomo?

Basic requirements:

  • Webserver (Apache, Nginx, IIS)
  • PHP 7.2.5+ (PHP 8.x recommended)
  • MySQL 5.5+ or MariaDB (MySQL 8+ recommended)
  • 128MB PHP memory limit minimum (256MB recommended)

For high traffic (1M+ actions/month): 2 servers minimum – separate database and app servers with 4+ CPU, 8GB+ RAM each.

How do I install Matomo?

For WordPress: Install the free „Matomo Analytics“ plugin from WordPress directory – no coding required.

For self-hosted:

  1. Download latest Matomo from matomo.org
  2. Create MySQL database and user
  3. Upload files via FTP in binary mode
  4. Visit your domain/matomo in browser
  5. Follow installation wizard

For Cloud: Sign up at matomo.org/cloud and add tracking code to your site.

Why is Matomo not tracking any visits?

Common causes and solutions:

  • JavaScript disabled: Ensure JavaScript is enabled in your browser
  • Tracking code missing: Verify the tracking code is on all pages
  • Wrong site ID: Check the tracking code has correct site ID (usually „1“ for first site)
  • Do Not Track enabled: Disable „Support Do Not Track“ in Privacy settings
  • Ad blockers: Some ad blockers block Matomo tracking
  • SSL issues: Ensure HTTPS is properly configured if using SSL

Is Matomo GDPR compliant?

Yes, Matomo is GDPR compliant and has been approved by the French Data Protection Authority (CNIL). Key features:

  • Data anonymization options
  • Cookieless tracking available
  • IP anonymization built-in
  • User opt-out mechanisms
  • Data retention controls
  • EU data hosting (Cloud version)

Unlike Google Analytics, Matomo doesn’t transfer data to the US, making it compliant with recent EU court rulings.

How much does Matomo cost?

Matomo On-Premise: Free core software, premium plugins cost $150-200/year per site

Matomo Cloud pricing (2024):

  • 50,000 hits/month: $23/month
  • 100,000 hits/month: $39/month
  • 500,000 hits/month: $129/month
  • 1M+ hits: Custom pricing

WordPress plugin: Free basic version, premium features $189-199/year

Can I import my Google Analytics data to Matomo?

Yes, Matomo offers a Google Analytics Importer that can transfer your historical data from Universal Analytics (GA3) to Matomo. This helps preserve your historical data when switching from Google Analytics. The importer handles most standard reports and metrics.

What’s the difference between Matomo for WordPress and On-Premise?

Matomo for WordPress:

  • Easier installation (plugin)
  • User management via WordPress
  • Automatic geolocation setup
  • No manual cron jobs needed
  • Limited to WordPress sites

Matomo On-Premise:

  • Full feature access
  • Multi-site management
  • API access
  • Log analytics support
  • Advanced configuration options

How do I troubleshoot login issues?

Common login troubleshooting steps:

  • Password reset: Use „Lost your password?“ link
  • Clear cookies: Enable cookies for Matomo domain
  • Disable ad blockers: Some may block login functionality
  • Try HTTPS: If using HTTP, try HTTPS login
  • Check proxy settings: Configure proxy headers if using proxy
  • Browser cache: Clear browser cache and try again

What happens after Matomo updates?

If Matomo stops working after an update:

  • Clear browser cache and cookies
  • Check file permissions (644 for files, 755 for directories)
  • Verify all files uploaded correctly
  • Check server error logs
  • Disable plugins temporarily
  • Run the database update script if prompted

Cloud users get automatic updates without manual intervention.

How do I set up archiving for high-traffic sites?

For sites with 100,000+ page views per month, set up automatic archiving:

Then disable browser archiving in config:

How do I configure Matomo for GDPR compliance?

Key GDPR configuration steps:

  1. Anonymize IPs: Go to Privacy → Anonymize data → Enable IP anonymization
  2. Disable cookies: Enable „Force tracking without cookies“
  3. Data retention: Set automatic data deletion periods
  4. User consent: Implement opt-out mechanisms
  5. Privacy policy: Update with Matomo data collection details

Where can I get help and support?

Matomo support resources:

  • Documentation: matomo.org/faq and matomo.org/help
  • Community forums: Free support from community
  • Professional support: Paid support plans for On-Premise
  • Cloud support: Included with Cloud subscriptions
  • Developer zone: API documentation and development guides
  • Video tutorials: Step-by-step installation and usage guides

Can I use Matomo for free?

Yes, Matomo offers several free options:

  • On-Premise: Core software completely free, host on your servers
  • WordPress plugin: Free version with essential analytics features
  • Cloud trial: 21-day free trial with full features

Premium features like heatmaps, A/B testing, and advanced segmentation require paid plans or plugins.

Let’s Talk!

Looking for a reliable partner to bring your project to the next level? Whether it’s development, design, security, or ongoing support—I’d love to chat and see how I can help.

Get in touch,
and let’s create something amazing together!

RELATED POSTS

Content editing in Elementor Elementor excels at layout-building and design flexibility, but when it comes to long-form content or complex structured text, traditional editors quickly hit their limits. That’s where the Gutenberg Editor — specifically the Isolated Block Editor (IBE) — becomes a game-changer. TinyMCE simply doesn’t hold up inside Elementor, and after years of […]

If you’ve ever tried to style text in a WYSIWYG editor and ended up with HTML that looked like a spaghetti disaster, you’ve already met the reason why semantic editors meaning, structure, and sanity. In other words: they keep your content clean, organized, and machine-friendly. This article walks you through the most important semantic and […]

If you’ve ever worked with text editors on the web, you know the routine: dependencies everywhere, fragile integrations, and editors that only behave when the stars align. The Isolated Block Editor (IBE) solves this by taking the core of Gutenberg and making it work anywhere — no WordPress environment required. It gives you the power […]

Alexander

I am a full-stack developer. My expertise include:

  • Server, Network and Hosting Environments
  • Data Modeling / Import / Export
  • Business Logic
  • API Layer / Action layer / MVC
  • User Interfaces
  • User Experience
  • Understand what the customer and the business needs


I have a deep passion for programming, design, and server architecture—each of these fuels my creativity, and I wouldn’t feel complete without them.

With a broad range of interests, I’m always exploring new technologies and expanding my knowledge wherever needed. The tech world evolves rapidly, and I love staying ahead by embracing the latest innovations.

Beyond technology, I value peace and surround myself with like-minded individuals.

I firmly believe in the principle: Help others, and help will find its way back to you when you need it.