6.4 (current)



We provide two kinds of virtualization, a vagrant and a docker based solution. Our developers use the docker containers mainly. These containers are also used in our continuous integration process. The supported functions are for both systems equal if the host systems is based on Linux. Instead of testing windows in combination with docker we evaluated the vagrant setup.
If you want to install the B2B-Suite for production environment your system must fit with the defined requirements from the Shopware core.

Minimum Requirements

The B2B Suite is based on the minimum requirements of the Shopware core.
These requirements apply from B2B Suite 4.6.0 and above:
  • Shopware 6.4
  • PHP 7.4.3
  • MySQL 5.7.21
  • MariaDB 10.3.22
Like in the Shopware 6 core MySQL 8.0.20 and MariaDB 10.3.29, 10.4.19, 10.5.10 are not supported because of technical issues.

Installation on a Linux based system

As minimum requirement, we need a docker runtime with version 1.12.* or higher. psh.phar provides the following available docker commands:
./psh.phar docker:start # start & build containers
./psh.phar docker:ssh # ssh access web server
./psh.phar docker:ssh-mysql # ssh access mysql
./psh.phar docker:status # show running containers and network bridges
./psh.phar docker:stop # stop the containers
./psh.phar docker:destroy # clear the whole docker cache
To start the docker environment just type
./psh.phar docker:start
on your command line. The several containers are booted and afterwards you can login into your web container with
./psh.phar docker:ssh
After that, you can start the initialization process by typing
./psh.phar init
After a few minutes, our test environment should be available under the address
To get a full list of available commands, you can use

Installation on a OS X based system

The following commands are available to create a mac setup. Apache, MySQL and ant are required. You can use brew package manager to install them.
./psh.phar mac:init # build installation
./psh.phar mac:start # start apache, mysql
./psh.phar mac:stop # stop apache, mysql
./psh.phar mac:restart # restart apache, mysql
You can change the database configuration in your own .psh.yaml file.
- "dev-ops/mac/actions"
For a better explanation, use the provided .psh.yaml.dist file as an example.


Once the environment has booted successfully, you can use the common scripts to setup shopware
./psh.phar clear # remove vendor components and previously set state
./psh.phar init # init composer, install plugins
./psh.phar unit # execute test suite
Last modified 5mo ago