Skip to content
Piwik Development Environment (Vagrant)
Puppet Ruby Shell PHP Pascal
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Piwik Development Environment

This configuration makes it very easy to start with Piwik development or to give Piwik a try in your local environment. It'll setup a virtual machine including everything you need to run Piwik.

Need more information? Have a look here:

Available Vagrant Boxes

  • Ubuntu Precise 32
  • Ubuntu Precise 64


  1. Install Vagrant & VirtualBox
  2. Clone this repository including all submodules (git clone --recursive
  3. This step is optional. If you want any changes of the defaults, you can make changes in a local vagrant configuration. Have a look at vagrantconfig.yaml for a list of possible settings.

    cp vagrantconfig_local.yaml-dist vagrantconfig_local.yaml

  4. Execute the command vagrant up within a vagrant/$box folder
  5. That's it. It'll take some time when executing this command the first time. It'll download the Vagrant base box once and install all required packages.
  6. Don't forget to update your local hosts file. You have to add "apache.piwik" as well as "nginx.piwik".


Open "http://apache.piwik" or "http://nginx.piwik:8080" after installation. You'll see the Piwik installation screen.

Installed Packages

  • PHP
  • PHP QA Tools (PHPUnit, PHPMD - PHP Mess Detector, PHP Depend, PHP CodeCoverage, PHP_CodeSniffer, ...)
  • Apache2
  • MySQL
  • Percona-Toolkit
  • Subversion
  • Git
  • Composer

You'll find Piwik here: /var/www/piwik

Let us know if you miss something.

Something went wrong with that request. Please try again.