Check matomo-version


This plugin lets you track if a matomo server update is available. To check for updates, this plugin uses the Git Repo at To compare against the current/installed version of Matomo, the check has to run on the Matomo server itself and needs access to the Matomo installation directory.

Fact Sheet

Check Plugin Download

Check Interval Recommendation

Once a day

Can be called without parameters


Compiled for

Linux, Windows

Uses SQLite DBs



usage: matomo-version [-h] [-V] [--always-ok] [--cache-expire CACHE_EXPIRE]
                      [--path PATH]

This plugin lets you track if server updates are available.

  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --always-ok           Always returns OK.
  --cache-expire CACHE_EXPIRE
                        The amount of time after which the update check cache
                        expires, in hours. Default: 24
  --path PATH           Local path to your Matomo/Piwik installation,
                        typically within your Webserver's Document Root.
                        Default: /var/www/html/matomo

Usage Examples

./matomo-version --path /var/www/html/matomo
./matomo-version --path /var/www/html/matomo --cache-expire 8 --always-ok


Matomo v4.3.1 is up to date


  • If wanted, always returns OK,

  • else returns WARN if update is available.

Perfdata / Metrics

There is no perfdata.

Credits, License