Connecting Matomo

You can integrate a metrics collection service into your documentation portal. This will allow you to view detailed information, such as who accessed which article, from where, and whether they came via search or a link.

Matomo

  1. Create a tracker in Matomo.

  2. In Gramax’s docker-compose.yaml, add the following environment variables for this tracker:

    • MATOMO_SITE_ID — The site ID in Matomo. Optional if MATOMO_CONTAINER_URL is specified.

    • MATOMO_URL — The URL of the Matomo instance. This parameter is mandatory if MATOMO_SITE_ID is used. Example: https://matomo.gram.ax or https://metrics.gram.ax/matomo.

    • MATOMO_CONTAINER_URL — The URL of the Matomo container. Optional. Learn more.

      • It can be absolute (if MATOMO_URL is absent). Example: https://matomo.gram.ax or https://metrics.gram.ax/matomo.

      • It can be relative (if MATOMO_URL is present). Example: / or /metrics/matomo.

  3. Restart docker-compose.yaml.