Installing in Development mode on Windows

Edit on GitHub

This document describes how to install Spryker in Development Mode on Windows.

Installing Docker prerequisites on Windows

To install Docker prerequisites on Windows with WSL1, follow Installing Docker prerequisites on Windows with WSL1.

To install Docker prerequisites on Windows with WSL2, follow Installing Docker prerequisites on Windows with WSL2.

Installing Spryker in Development mode on Windows

Follow the steps to install Spryker in Development mode:

  1. Open Ubuntu.

  2. Open a terminal.

  3. Create a new folder and navigate into it.

  4. Depending on the desired Demo Shop:

    • Clone the B2C repository:
    git clone https://github.com/spryker-shop/b2c-demo-shop.git -b 202108.0  --single-branch ./b2c-demo-shop
    
    • Clone the B2B repository:
    git clone https://github.com/spryker-shop/b2b-demo-shop.git -b 202108.0  --single-branch ./b2b-demo-shop
    
  5. Depending on the repository you’ve cloned, navigate into the cloned folder:

    • B2C repository:
    cd b2c-demo-shop
    
    • B2B repository:
    cd b2b-demo-shop
    
Verification

Make sure that you are in the correct folder by running the pwd command.

  1. In deploy.dev.yml, define image: with the PHP image compatible with the current release of the Demo Shop:
image: spryker/php:7.3-alpine3.12
  1. Clone the Docker SDK repository:
git clone https://github.com/spryker/docker-sdk.git --single-branch docker
  1. In {shop_name}/docker/context/php/debug/etc/php/debug.conf.d/69-xdebug.ini, set xdebug.remote_host and xdebug.client_host to host.docker.internal:
...
xdebug.remote_host=host.docker.internal
...
xdebug.client_host=host.docker.internal
  1. Add your user to the docker group:
sudo usermod -aG docker $USER
  1. Bootstrap local docker setup:
docker/sdk bootstrap deploy.dev.yml
Bootstrap

Once you finish the setup, you don’t need to run bootstrap to start the instance. You only need to run it after you update the Docker SDK or the deploy file.

  1. Update the hosts file:

    1. Open the Start menu.
    2. In the search field, enter Notepad.
    3. Right-click Notepad and select Run as administrator.
    4. In the User Account Control window, select Yes to confirm the action.
    5. In the upper navigation panel, select File > Open.
    6. Put the following path into the address line: C:\Windows\System32\drivers\etc.
    7. In the File name line, enter hosts and select Open. The hosts file opens in the drop-down.
    8. Follow the installation instructions in the white box from the docker/sdk bootstrap command execution results to prepare the environment.

    You can run docker/sdk install after bootstrap to get the list of the instructions.

    1. Select File > Save.
    2. Close the file.
  2. Once the job finishes, build and start the instance:

docker/sdk up

Depending on the hardware performance, the first project launch can take up to 20 minutes.

Endpoints

To ensure that the installation is successful, make sure you can access the configured endpoints from the Deploy file. See Deploy file reference - 1.0 to learn about the Deploy file.

RabbitMQ UI credentials

To access RabbitMQ UI, use spryker as a username and secret as a password. You can adjust the credentials in deploy.yml.

Getting the list of useful commands

To get the full and up-to-date list of commands, run docker/sdk help.

Next steps