Skip to content


Setting up Piwik manually or headless install not supported #991

robocoder opened this Issue · 6 comments

3 participants


We provide config/config.ini.sample.php, which implies that a user could copy and configure this manually as config.ini.php.

  • if the db user doesn't exist, Piwik reports:
SQLSTATE[28000] [1045] Access denied for user "%s"

(followed by a backtrace)

  • if db user exists but not the database, Piwik reports:
SQLSTATE[42000] [1049] Unknown database "%s"

(followed by a backtrace)

  • if db user and database exist, but not the tables, Piwik reports:
Critical Error during the update process:

Database piwik is empty. You must edit or remove your Piwik configuration file.
  • if user bypasses the Installation, things like the anonymous user and default site are not created


  • for database user that doesn't exist, provide help
  • for missing database or tables, prompt to remove the config file and redirect to installer, using the settings to pre-fill the forms; (we don't want to remove the config file without user confirmation, in case Piwik simply lost its connection to the MySQL server)
Piwik Open Source Analytics member

sounds good - also, a simple solution could be to explain in a comment in config.sample that this is not meant to be copied, users should go through the installation process first etc.

Piwik Open Source Analytics member

I vote for a comment in config.sample.ini to explain that this is not meant to be copied with a link to the installation guide (


In [1569], refs #991 - add comment to config.ini.sample.php to not copy this file


Have a look into the repository of EXT:piwikintegration for TYPO3.



Here is the direct link to the helper class with the function makePiwikConfigured:

This class is used to fetch, extract and install piwik fully automated. It supports updating existing databases. It's forced to use a hardcoded prefix, to make it compatible with TYPO3.

The tracking code is developed in a standalone extension:

Best regards Kay


I've added a reference to comment:7 to #161.


(In [1742]) fixes #991 - redirect to Installation 'welcome' (displaying alternate text & error message) if database connection fails

@robocoder robocoder added this to the Piwik 0.5.5 milestone
This issue was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.