Self-host Matomo Analytics on your own servers to ensure data remains in your hands! It’s for this reason that Matomo On-Premise is, and forever will remain free to download.

In the guides below you will learn how to install Matomo on your servers (Linux Debian or Windows instructions are provided), including instructions around maintaining Matomo including securing your service, updating to the latest version, customising Matomo with plugins and themes and all troubleshooting FAQs.

You will also find advanced documentation on improving performance and building a scalable Matomo architecture. With 10% of the top 10,000 websites in the world use Matomo On-Premise for their analytics, with the community's help, we've documented all our knowledge from running Matomo at scale.


 
Find and copy the system check in Matomo On-Premise I get ‘Oops… there was a problem during the request.’ or ‘Internal Server Error’ or ‘500 error’ or the ‘White screen of death’. How do I proceed?Matomo does not track visits on SSL / HTTPS pages.Matomo reporting UI doesn’t have any css style or, the menu text appears on a white background, or I get JavaScript errors in the Matomo UI. How to fix this display problem?Enable unicode characters (Japanese, Chinese, Russian, Hebrew, Arabic, etc.) in graphs in PDF/HTML reports and Matomo Mobile graphsSparklines (evolution graphs) are missing in the Matomo dashboard.Emails from Matomo are not being sent, how do I troubleshoot and solve the issue?I’m a developer, how do I enable logging (and / or SQL profiling) in Matomo?Graphs in PDF/HTML reports and/or Matomo Mobile do not display characters correctly in my language (display squares instead).Why am I getting a warning about an untrusted hostname?Find the cause of the Brute Force detection blocking access from a specific IPAntivirus program or malware checker or Google Ads claim that matomo.js or piwik.js are malware, what can I do?Matomo is slow after creating a custom report, funnel or installing users flowWhy some pages or actions show a lower pageviews metric, but for a longer time period?Matomo doesn’t show me when new updates are available, and the SEO plugin doesn’t work.Almost all reports and dates are working fine except one or a small number of days/weeks/months/date ranges which display zero visit. How do I fix this issue and restore the missing data?Force the reports to be re-processed from the logsAll visitors have the same IP address and Provider. How do I track individual IPs?How do I fix that the time is off by one hour? (timezone that doesn’t use the correct offset)I get the error Warning: Unexpected character in input: ‘\’ (ASCII=92) state=1Matomo reports this error and doesn’t continue: “Fatal error: Maximum execution time of 30 seconds exceeded in …”Fix the error “Call to undefined method MaxMind\Db\Reader::getWithPrefixLen()”Matomo reports this error and fails: “Fatal error: Allowed memory size of X bytes exhausted (tried to allocate X bytes)”. What should I do?Emails sent from Matomo use the email address @defaultHostnameIfEmpty.example.org, how do I specify my domain name instead?Fix the error “Parse error: syntax error, unexpected T_STRING in …”I get the error message: “Fatal error: require_once() [function.require]: Failed opening required XYZ in /path/piwik/XYZ.php on line X”. How can I get Matomo to work?“Segmentation fault Error”. Matomo reporting or via cron crashes with Segmentation Fault error. What to do?Fix the errors “Unable to write in the cache directory” or “The directory matomo/tmp/cache/*” is not writable.”I get: PHP Fatal error Call to undefined function imagecreatefrompng()I get the error message: “Fatal error: Class ‘not found in …”. What’s wrong?Fix the error “SMTP Error: Could not authenticate.”Fix the error ‘Fatal error: Maximum function nesting level of ‘100’ reached, aborting!’I get the error “Warning: gzuncompress() [function.gzuncompress]: data error” when looking at my Matomo reports.Fix the error private directories are accessibleWhy many of my visits have “0 Action” in Matomo and how do I fix this issue?Fix timeout errors when trying to create a user auth tokenTroubleshoot when Chrome shows a warning on your Matomo domain