2.0.0

Release Notes - v2.0.0

Breaking Changes

This release simplifies the environment configuration by eliminating duplicate variables between the database and application containers.

Migration Required

Users upgrading from v1.x must update their .env files. The following variables have been removed:

• MATOMO_DATABASE_HOST
• MATOMO_DATABASE_ADAPTER
• MATOMO_DATABASE_DBNAME
• MATOMO_DATABASE_USERNAME
• MATOMO_DATABASE_PASSWORD
• MATOMO_DATABASE_TABLES_PREFIX

Migration Steps

1. Back up your existing .env file
2. Copy the new .env.example to .env
3. Update passwords and port configurations as needed
4. Run make restart to apply changes

New Features

Makefile Enhancements

• Environment validation: Commands now verify .env exists before execution
• make init: Creates .env from template with setup instructions
• make shell: Direct access to Matomo container for console commands
• make db and make db-root: Database CLI access without remembering credentials

Simplified Configuration

• Single source of truth for database credentials
• Hardcoded static values that never change (database hostname, adapter)
• Optional table prefix with sensible default
• Reduced configuration complexity and potential for errors

Technical Details

• Docker Compose configuration now maps MariaDB environment variables directly to Matomo
• Database hostname db is hardcoded as it's internal to the Docker network
• MySQL adapter hardcoded as it never changes for MariaDB
• Table prefix defaults to matomo_ if not specified

Compatibility

• Requires Docker Compose v1 or v2
• Compatible with latest Matomo and MariaDB images
• Tested on macOS and Linux