Matomo Web Analytics

Overview

Matomo is an open-source web analytics platform. This stack runs Matomo with a MariaDB database.

Project Details

Project Repository: https://github.com/matomo-org/matomo
Container Image: Docker Hub
Documentation: https://matomo.org/docs
Reverse Proxy Port: 80

Getting Started

Start the stack: docker compose up -d
Open http://localhost:${MATOMO_PORT:-8080} in your browser
Follow the web setup wizard, using database host matomo-db

Environment Variable Notes

VOL_PATH – base path for persistent data volumes
VOL_PROJECTS – base path for project directories
MATOMO_IMAGE – Matomo container image (default: matomo:latest)
MATOMO_RESTART – restart policy (default: unless-stopped)
MATOMO_PORT – host port mapped to container port 80 (default: 8080)
MATOMO_DB_IMAGE – MariaDB container image (default: mariadb:10.4)
MATOMO_MYSQL_ROOT_PASSWORD – MariaDB root password
MATOMO_MYSQL_PASSWORD – MariaDB matomo user password
MATOMO_DB_PASSWORD – Matomo's database password (must match MATOMO_MYSQL_PASSWORD)

Volume Notes

${VOL_PATH}/matomo_dev/db – MariaDB data directory
${VOL_PATH}/matomo_dev/html – Matomo application files
${VOL_PATH}/matomo_dev/config – Matomo configuration
${VOL_PATH}/matomo_dev/logs – Matomo log files

Network Notes

Requires the external proxy network (Nginx Proxy Manager). An internal bridge network internal is created for inter-service communication.

Docker Run

docker run -d \
  --name matomo \
  -v ${VOL_PATH:-/data}/matomo_dev/html:/var/www/html \
  -v ${VOL_PATH:-/data}/matomo_dev/config:/var/www/html/config \
  -v ${VOL_PATH:-/data}/matomo_dev/logs:/var/www/html/logs \
  -e MATOMO_DB_HOST=matomo-db \
  -e MATOMO_DB_USER=matomo \
  -e MATOMO_DB_PASSWORD=changeme \
  -e MATOMO_DB_NAME=matomo \
  -p 8080:80 \
  --network proxy \
  matomo:latest

Additional Notes / Gotchas

On first run, Matomo will guide you through the setup wizard. Use matomo-db as the database host.
The MATOMO_DB_PASSWORD env var must match the MYSQL_PASSWORD set for the MariaDB matomo user.

Dockhand Stack, Deploy from Git

Cookbooks Repository stackname: MATOMO_DEV Compose file path: matomo_dev/compose.yaml Additional env file (optional): matomo_dev/sample.env

Then "Load" matomo_dev/sample.env into the Environmental variables in dockhand

Create the Stack

2.5 KiB Raw Permalink Blame History Unescape Escape