You are browsing the latest version of the documentation which is not released yet. See the current stable version instead.

Installation Using Docker for Linux

This guide covers building new projects based on Shopsys Framework. If you want to contribute to the framework itself, you need to install the whole shopsys/shopsys monorepo. Take a look at the article about Monorepo for more information.



1. Create new project from Shopsys Framework sources

composer create-project shopsys/project-base --no-install --keep-vcs
cd project-base


  • The --no-install option disables installation of the vendors - this will be done later in the Docker container
  • The --keep-vcs option initializes GIT repository in your project folder that is needed for diff commands of the application build and keeps the GIT history of shopsys/project-base

2. Installation

Now, you have two options:

Option 1

In the case you want to start demo of the application as fast as possible, you can simply execute the installation script and that is all:


After the script is finished with installing the application, you can skip all the other steps and see the last chapter of Application Setup Guide to get all the important information you might need right after the installation.

Option 2

If you want to know more about what is happening during installation, continue with the steps #2.1 - #2.4.

2.1 Create docker-compose.yml file

Create docker-compose.yml from template docker-compose.yml.dist.

cp docker/conf/docker-compose.yml.dist docker-compose.yml

2.2 Set the UID and GID to allow file access in mounted volumes

Because we want both the user in host machine (you) and user running php-fpm in the container to access shared files, we need to make sure that they both have the same UID and GID. This can be achieved by build arguments www_data_uid and www_data_gid that should be set to the UID and GID as your own user in your docker-compose.yml.

You can find out your UID by running id -u and your GID by running id -g.

2.3 Compose Docker container

docker-compose up -d --build


During the build of the docker containers there will be installed 3-rd party software as dependencies of Shopsys Framework by Dockerfile with licenses that are described in document Open Source License Acknowledgements and Third-Party Copyrights

2.4 Setup the application

Application setup guide