You have two options here: either you create a new site just for Piwik, or you create a second database for an existing site. By default, we limit the number of data bases per site to one, but we can raise this limit to allow more. Just contact our support team.
Clone the git repo of the site you want to install Piwik to and unpack the Piwik tarball or zipfile into the docroot/ directory, but do not yet push. It is important that Piwik is reachable under the /piwik location (e. g., www.domain.com/piwik) as we already have our default Varnish configuration set up in a way to properly handle Piwik.
Parts of Piwik must be writeable and thus reside in the shared storage of freistilbox. These parts must not be checked in via git, but you need to copy them there once not using git. So move (not copy!) this directory out of the git repository:
mv /docroot/piwik/config /tmp
The files inside that directory need to be copied after you have pushed the repository (don’t do that yet), see below.
Append these lines to your existing .gitignore file:
The [Boxfile][boxfile] configures the shared folders for this site. For Piwik, you need at least these entries:
version: 2.0 shared_folders: - docroot/piwik/tmp - docroot/piwik/config
Create a file called
.user.ini in the docroot/ directory containing at least this:
Commit all changes and deploy them using
Copy the files you moved to
/tmp before to the shellhost, and there to the correct location. You can do this by issuing:
rsync -avz /tmp/config/* sSITE-ID@cCLUSTER-IDs.freistilbox.net:current/docroot/piwik/config
Replace SITE-ID and CLUSTER-ID with the correct values for your site and cluster. The actual command would look like this:
rsync -avz /tmp/config/* email@example.com:current/docroot/piwik/config
Confirm your installation is working. As mentioned above, the core functionallity will work, but you may encouter error messages saying that piwik.js is not writeable. If you encounter any issues, do not to hesitate contact our support team.