Hi everyone, I’m new to Matomo and I’m at a company that uses Matomo version 3.13.6. I’d like to upgrade to the latest version, but because the difference is so big, I’m worried about potential problems if I upgrade directly.
What do you suggest? Would it be better to upgrade to version 4 first and then to version 5?
How can I do this?
Welcome André! Jumping from 3.13.6 to the newest version is definitely a pretty big gap, so your concern makes sense.
If it were me, I’d probably feel safer reviewing compatibility step by step first instead of rushing a direct upgrade, especially if the setup has older plugins or custom tracking configurations.
Hopefully, some experienced Matomo users here can share how they handled similar upgrades without breaking reporting or historical data.
I would copy the existing installation into a development domain and different database. Make sure to configure the database credentials in “config/config.ini.php” so you will not accidentally still access the production database.
Before you start, make a backup of the files and database so you can easily start over again. Or use a snapshot if using a dedicated virtual server or local VM.
Then try the big jump to the newest version. If this succeeds, you are lucky and don’t have to do the single steps.