Government of British ColumbiaGovernment of British Columbia

DevHub

beta
Resource Information

Matomo OpenShift

Matomo is a fully featured web analytics server and is a great alternative to Google Analytics when data ownership and privacy compliance are a concern.

Matomo OpenShift provides a set of OpenShift configurations to set up an instance of the Matomo web analytics server. See: matomo.org for additional details regarding Matomo.

Architecture

The service is composed by the following components:

  • matomo: includes two containers within a single pod, the matomo analytics instance and matomo-proxy, which is the nginx used to proxy http requests.
  • matomo-db: a mariadb instance that will be used to store the analytics data.

Deployment / Configuration

The templates provided in the openshift folder include everything that is necessary to create the required builds and deployments.

Since there are interdependencies between deployment configurations, please make sure to follow this order when creating them for the first time:

  1. build and deploy the database
  2. build and deploy the Matomo analytics server and proxy

The manage script makes the process of adding a matomo instance to your project very easy. The script was build on the openshift-developer-tools scripts.

Once you've cloned the repository, open a bash shell (Git Bash for example) to the openshift directory of the working copy.

The following example assumes an OpenShift project set named ggpixq ...

  1. ./manage -n ggpixq init - to initialize the configurations to be deployed into your project.
  2. ./manage build - to publish the build configuration(s) into your tools project and start the build.
  3. ./manage -e prod deploy - to publish the deployment configuration(s) into your prod environment and tag the application images to start the deployments.
  4. Browse to the deployed application to complete the configuration.

The deployment will have created two sets of secrets for you to referance while completing the initial configuration; matomo-db, containing the database info and randomly generated credentials and matomo-admin, containing randomly generated credentials for your main super-user account.

For full script documentation run ./manage -h.

First Run

Once everything is up and running in OpenShift, follow the instructions to create your superuser, set-up the connection to the database and initialize the Matomo dashboard.

To start tracking, copy the snippet for the appropriate website in the Matomo dashboard and place it in your website.

  • Create an Issue
  • home
  • disclaimer
  • privacy
  • accessibility
  • copyright
  • contact us
  • Government Of BC