mirror of
https://github.com/nickyeoman/docker-compose-cookbooks.git
synced 2026-09-04 02:46:23 +00:00
75 lines
2.5 KiB
Markdown
75 lines
2.5 KiB
Markdown
# 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](https://github.com/matomo-org/matomo)
|
||
- **Container Image:** [Docker Hub](https://hub.docker.com/_/matomo)
|
||
- **Documentation:** [https://matomo.org/docs](https://matomo.org/docs)
|
||
- **Reverse Proxy Port:** `80`
|
||
|
||
## Getting Started
|
||
|
||
1. Start the stack: `docker compose up -d`
|
||
2. Open http://localhost:${MATOMO_PORT:-8080} in your browser
|
||
3. 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
|
||
|
||
```bash
|
||
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
|