Update Piwik

Docs › Update Piwik

This page explains how to update your Piwik install to the latest version.

First option: The one-click update from within Piwik!

If your web server has the right permission to download Piwik automatically, you can use the one click upgrade and update your Piwik in 10 seconds… in just one click of a button!

Click on the alert box in Piwik

Note: after a new Piwik version is released, the message might take up to 24 hours to appear in the alert box.

Read the message and click Update Automatically

Watch the magic!

Treat yourself

Your Piwik is now updated! Why not share your experience with others by writing a blog post, or spend some time doing new analysis on the Piwik numbers (have you tried looking at your best websites referers, sorted by decreasing bounce rate?), or simply sit back for a few moments and enjoy the beauty of life!

Second option: The manual three-step update

If for some reason the one click update doesn't work for you, you can still update Piwik the traditional way.

Backup your configuration file

Please backup your Piwik configuration file in config/config.ini.php
This file contains the current settings for your existing installation, e.g. your database sign-in information and list of enabled plugins.

Replace the Piwik files and copy your old config file in the new Piwik

You can download the latest Piwik release from http://piwik.org/latest.zip. You can either download and extract it to your computer, or download it directly to the server if you have shell access.

Please make sure the new files overwrite all the old files with the same names, including the config/global.ini.php.

You can now restore your Piwik configuration file from your backup to the new config/config.ini.php

Update Piwik

Visit your Piwik installation using your web browser. If your new instance of Piwik requires changes to be made to the database, you will see this screen:

This will update your database so that it is compatible with the latest code. Please be patient: database updates (for example adding a new index) can take a few minutes. Do not close your browser or click refresh during this process. If you fail to carry out this step correctly your Piwik installation might display incorrectly or not work at all.