Matomo database will be upgraded from version 4.16.0 to the new version 5.0.1.
The following plugins will be updated: TagManager.
The following dimensions will be updated: log_conversion.pageviews_before.
Important notes for large Matomo installations
If you have a large Matomo database, updates might take too long to run in the browser. In this situation, you can execute the updates from your command line:
php /var/www/vhosts/web1773.server19.web4a.de/httpdocs/stats/console core:update
If you manage a high traffic Matomo server, we recommend to momentarily disable visitor Tracking and put the Matomo User Interface in maintenance mode.
FYI: these are the SQL queries and console commands that will be executed to upgrade your database to Matomo 5.0.1
› Click here to view and copy the list of SQL queries and console commands that will get executed
# These SQL queries will be executed:
DELETE FROM `matomo_archive_numeric_2020_05` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_05` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_05` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2020_12` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2020_12` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2020_12` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_02` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_02` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_02` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_03` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_03` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_03` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_04` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_04` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_04` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_05` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_05` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_05` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2021_12` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2021_12` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2021_12` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_02` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_02` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_02` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_03` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_03` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_03` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_04` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_04` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_04` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_05` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_05` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_05` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2022_12` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2022_12` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2022_12` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_02` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_02` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_02` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_03` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_03` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_03` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_04` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_04` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_04` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_05` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_05` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_05` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_06` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_06` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_06` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_07` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_07` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_07` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_08` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_08` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_08` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_09` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_09` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_09` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_10` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_10` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_10` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_11` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_11` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_11` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2023_12` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2023_12` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2023_12` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2024_01` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2024_01` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2024_01` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
DELETE FROM `matomo_archive_numeric_2024_02` WHERE ts_archived is null;
ALTER TABLE `matomo_archive_numeric_2024_02` DROP INDEX `index_idsite_dates_period`;
ALTER TABLE `matomo_archive_numeric_2024_02` ADD INDEX index_idsite_dates_period (`idsite`, `date1`, `date2`, `period`, `name` (6));
ALTER TABLE `matomo_user_token_auth` ;
ALTER TABLE `matomo_log_conversion` ADD COLUMN `pageviews_before` SMALLINT UNSIGNED DEFAULT NULL;
# These console commands will be run:
./console core:calculate-conversion-pages --dates=yesterday,today
# These SQL queries will be executed:
ALTER TABLE `matomo_log_visit` ADD INDEX `index_idsite_idvisitor_time` (`idsite`, `idvisitor`, `visit_last_action_time` DESC);
ALTER TABLE `matomo_log_visit` DROP INDEX `index_idsite_idvisitor`;
# These console commands will be run:
./console plugin:activate "JsTrackerInstallCheck"
# These SQL queries will be executed:
ALTER TABLE `matomo_user_token_auth` CHANGE `post_only` `secure_only` TINYINT(2) UNSIGNED NOT NULL DEFAULT '0';
ALTER TABLE `matomo_user` ADD COLUMN `ts_changes_shown` TIMESTAMP NULL;
ALTER TABLE `matomo_tagmanager_container` ADD COLUMN `ignoreGtmDataLayer` TINYINT(1) UNSIGNED NOT NULL DEFAULT 0 AFTER `description`;
ALTER TABLE `matomo_log_conversion` ADD COLUMN `pageviews_before` SMALLINT UNSIGNED DEFAULT NULL;
Need help upgrading Matomo?
If you need support to upgrade your Matomo, the creators of Matomo are here to help you make the Matomo upgrade a success and provide all instructions, best practises and ongoing support. Contact the Matomo experts to get started upgrading your Matomo safely.
Ready to go?
The database upgrade process may take a while, so please be patient.