Requesting a document that explains how to update Matomo app running on container images

[adelca]

Hi, can you provide a document that describes how to update a Matomo app running on a container image?

My particular case: I am running Matomo fpm-alpine on an EKS cluster + RDS.

I went from matomo:5.1.2-fpm-alpine to matomo:5.2.2-fpm-alpine and the UI still requested me to click on the update button.
There is no documentation about how to update a Matomo container using a new image, the closest I could find is this:
https://matomo.org/faq/on-premise/update-matomo/

Imho, his does not make sense, it says it will download new files which we dont need because I already updated the image.

Also, please consider automation/scripting ways of doing it, having to click on a button after updating Matomo docker image breaks CI/CD concept.

[michalkleiner]

Hi @adelca. Thank you for the suggestion on more documentation.
The container updates the code (the files), but you need to click the update in the UI to also update the version in the database and run any potential upgrade scripts/migrations at the time it most suits you. Just changing the files to newer versions or replacing the container with a newer version of it doesn't constitute a full update. For high traffic instances it is recommended to e.g. stop tracking for a bit or use queued tracking or put Matomo into maintenance mode and run the update from CLI, so it needs to be triggered manually based on how your Matomo instance is used.

[adelca]

Hi @michalkleiner thanks for replying.
Lets ignore high traffic instances for now... Are you saying that the only step needed, is running this command on the command line?
./path/to/matomo/console core:update

Can I do this in an init container (I am running Matomo in a kubernetes pod), before Matomo is running, or I need to exec it while Matomo app is running?

I still think a specific doc for docker containers (and Kubernetes maybe) would be of great help to many other people.

[michalkleiner]

When you say "Matomo is running", what exactly do you mean? It's a stateless web application, so it's not running per se. It's responding to requests and returns markup or API responses. As long as you can access the CLI and Matomo can access the database and respond to requests, you can run the console command.