matomo-ansible

Ansible playbook and Docker Compose setup for Matomo web statistics

Requirements

Requirements for local development (Docker setup)

• Docker Compose
• The images have been developed for the amd64 architecture

Requirements for deploying to server

• Ansible (>= 2.9)
• Vagrant (2.x - only for local VM)
• Enterprise Linux 9 (e.g. AlmaLinux or RHEL)
• The images have been developed for the amd64 architecture

Local development in containers (Docker)

If you use Windows, ensure that core.autocrlf is set to false in your git client before you clone the matomo-ansible
repository: git config --global core.autocrlf false Otherwise the Docker images may not work due to line
ending changes.

Building the images

If you want to test any local updates, you need to re-build the images:

cd docker
./build-local-images.sh

Running the application using Docker

First add an entry to your /etc/hosts file (or equivalent) so that queries for the development setup
interface resolve to your loopback interface. For example:

127.0.0.1 www.matomo.test

Unless you want to build the images locally (see above), you need to pull them from the registry:

cd docker
docker compose pull

Then start the Docker Compose setup:

docker compose up

Then wait until Matomo has started. This may take a couple of minutes. Navigate to
https://www.matomo.test in your browser. The development setup runs with
self-signed certificates, so you'll need to accept the security warning in your browser.

Run the setup wizard to configure Matomo

Local development VM

First create the VMs using Vagrant:

vagrant up

On a Windows host, first SSH into the Ansible controller virtual machine (skip this step on GNU/Linux or macOS):

vagrant ssh matomo-controller
cd ~/matomo-ansible

Deploy Matomo to the development virtual machine:

ansible-playbook playbook.yml

Add the following host to /etc/hosts (GNU/Linux or macOS) or %SystemRoot%\System32\drivers\etc\hosts (Windows):

192.168.60.10 dev.matomo.test

License

This project is licensed under the MIT license.
The full license can be found in LICENSE.