Official Repository

Last pushed: 2 days ago
Short Description
Piwik is the leading open-source analytics platform that gives you more than powerful analytics.
Full Description

Supported tags and respective Dockerfile links

For more information about this image and its history, please see the relevant manifest file (library/piwik). This image is updated via pull requests to the docker-library/official-images GitHub repo.

For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see the repos/piwik/ file in the docker-library/repo-info GitHub repo.


Piwik is the leading open-source analytics platform that gives you more than just powerful analytics:

  • Free open-source software
  • 100% data ownership
  • User privacy protection
  • User-centric insights
  • Customisable and extensible

How to use this image

$ docker run --name some-piwik --link some-mysql:db -d piwik

Now you can get access to fpm running on port 9000 inside the container. If you want to access it from the Internets, we recommend using a reverse proxy in front. You can find more information on that on the docker-compose section.

Via docker-compose

You can use a setup that is used in production at IndieHosters/piwik.


Once started, you'll arrive at the configuration wizard. At the Database Setup step, please enter the following:

  • Database Server: db
  • Login: root
  • Database Name: piwik (or you can choose)

And leave the rest as default.

Then you can continue the installation with the super user.


Pull requests are very welcome!

We'd love to hear your feedback and suggestions in the issue tracker:


This product includes GeoLite data created by MaxMind, available from


View license information for the software contained in this image.

Supported Docker versions

This image is officially supported on Docker version 17.03.0-ce.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

User Feedback


If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a cve-tracker issue on the official-images repository first.

You can also reach many of the official image maintainers via the #docker-library IRC channel on Freenode.


You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.


Documentation for this image is stored in the piwik/ directory of the docker-library/docs GitHub repo. Be sure to familiarize yourself with the repository's file before attempting a pull request.

Docker Pull Command

Comments (4)
5 months ago

Hi sstrigler,

same problem here, but everything is fine with tags and latest. I found a way to upgrade my container. You need to know two things:

  1. installs Piwik to /usr/src/piwik and creates a volume /var/www/html
  2. copies /usr/src/piwik to /var/www/html

I use a setup with docker-compose with a second nginx container. Both containers share /var/www/html.

A simple docker pull piwik is not enough, you need to delete files in /var/www/html or remove both containers (delete volume). After this you can start a new container from piwik:2.16.5. Hope this helps...

6 months ago

'latest' is not set to '2.16.5', '2.16.5' seems to contain piwik 2.16.2.

6 months ago


7 months ago

Hi folks.
As per
It would really really help if you added some instruction that the Piwik instance is in a php-fpm server that only serves fast-cgi, not http, and that you have to put an nginx server in front of it to use http :-)