Warning: You are browsing the documentation for PrestaShop 1.7, which is outdated.

You might want to read an updated version of this page for the current version, PrestaShop 8. Read the updated version of this page

Learn how to upgrade to the latest version.

How to test Pull Requests

Tests determine the quality of a software. This process involves evaluating information that is related to a shop.

To make testing easier, we provide a Vagrant configuration designed for testing branches and pull requests.

What is installed

  • Debian 10 Buster
  • Git
  • Apache 2.4
  • Multiple PHP versions (7.1, 7.2, 7.3, 7.4)
  • MariaDB 10
  • NodeJS


First of all you need two tools to run this project:

If you’re using Windows, we recommend you to download Git bash and execute all commands under this shell.

Why Vagrant

We use Vagrant because of its flexibility and portability. With it, you can control every aspect of the machine, and help us by having a similar environment to reproduce issues.

Getting started

The process is pretty simple.

First, you must clone the repository https://github.com/PrestaShop/vagrant.

Second, execute the script run.sh (or run.bat if you’re under Windows) and follow instructions.

Most of the time, there is a prompt asking for a network interface, remember it’s the communication between the virtual machine and the network card.

Running the run.sh script

The first installation will take a while, because it needs to download the vagrant box, installs all needed packages and configures the system to make it compatible with PrestaShop.

Script running successfuly

Then, visit

phpMyAdmin is also available at


Available PHP versions

  • 7.1
  • 7.2
  • 7.3
  • 7.4
Be aware that some PrestaShop versions are not compatible with all the above environments. See System requirements to find out which version is compatible with which PHP version.



phpMyAdmin is available at

  • MySQL Host:
  • Database name: prestashop
  • Username: prestashop
  • Password: prestashop
  • Port: 3306


You can login into the virtual machine with vagrant ssh


If something went wrong during the installation, the error is displayed explaining which command is failing.

  • Invalid branch name:

    Invalid git branch name

  • Invalid PHP version:

    Invalid PHP version