For Piwik to work correctly, your web browser should be able to download from your Piwik server a set of HTML files. This FAQ explains what are various ways to configure your server to deliver Piwik HTML files.

To test whether your server can serve HTML, visit this URL: demo.piwik.org/plugins/MultiSites/angularjs/dashboard/dashboard.directive.html (replace demo.piwik.org with your Piwik URL). If this HTML page on your server looks the same as this page then your server is configured properly to serve HTML files!

If the test does not succeed then you need to enable your server to correctly serve HTML files for Piwik:

  • if you are using Apache as webserver, put AddHandler text/html .html in the <directory> section of the Apache host config. Restart the webserver.
  • if you are using Nginx, check out the Piwik-Nginx configuration. Note: make sure you replace the corresponding line in the piwik-nginx configuration with your own domain(s): valid_referers none blocked *.mysite.com othersite.com; (if that is too much of a hassle for you then just comment out the valid_referers block.)
  • if you are using the module Pagespeed in your server, please note that (pagespeed extension does not work with Piwik). You may disable pagespeed for Piwik by adding this to the apache config: ModPagespeedDisallow "path_to_piwik_here"
  • if you still have issues serving HTML files, verify that your server does not redirect requests from index.php to index or from index.php to /. Such redirects may cause loss of POST variables causing issues.
  • if you still have issues serving HTML files, try to recursively change permission on the path/to/piwik/plugins folder (chmod -R 755 plugins/)

If you have other suggestions to add to this list, please use the form in this page.