Installation Guide - Windows (Docker)

This is a non-production version.

Installing Demoshop on a Windows Machine

The following article describes how to install Spryker demoshop on your Windows machine.

  1. Install Docker and Docker-compose on your PC.
    • Download InstallDocker.msi here.
    • Run the installer and follow the provided installation steps.
  2. For Docker to Start successfully, Log out your Windows user and then log in again.
  3. Start Docker for Windows application from your Desktop or Applications menu. The system will ask you to restart PC for starting Hyper-V virtualisation:

  4. You need to have virtualization enabled in your BIOS if you have this error:

    Specific steps on virtualization enabling depend on your BIOS and hardware, but in the most cases you should enter BIOS configuration mode, go to Configuration tab and enable Intel Virtual Technology there.

  5. Start 'terminal` command line interface:
    • Press Windows key.
    • Type terminal in the search field and press Enter key.
  6. Create a working folder in your home directory with the following terminal commands:
    C:\Users\voronin>mkdir demoshop
    C:\Users\voronin>cd demoshop
  7. Download docker-compose.yml ( file and put it to the created directory. In our case this is C:\Users\voronin\demoshop`.
  8. Start your docker-compose with terminal:
    docker volume create app-sync
    docker volume create jenkins-sync
    docker-compose up -d
  9. Make changes in in your hosts file for DNS needs:
    • Press the Windows key.
    • Type Notepad in the search field.
    • In the search results, right-click Notepad and select Run as administrator.
    • From Notepad, open the following file: C:\Windows\System32\drivers\etc\hosts
    • Add these two strings in the end of the hosts file:
    • Click File->Save to save your changes.
  10. Use the following URLs to access the demoshop: and

Starting the Demoshop

For Demoshop to start smoothly, it is recommended to first disable the experimental features in Docker. To disable the experimental features, do the following:

  • Right-click on Docker icon in tray and select Settings.
  • Select “Daemon” tab and remove the tick from Experimental features checkbox.
  • Restart the Docker containers by executing the following commands:
  • docker-compose down
    docker-compose up -d 

After that you are all set to start your Demoshop. Do the following:

  1. Starting `terminal` command line interface:
    • Press the Windows key.
    • Type `terminal` in the search field and press Enter.
  2. Go to the folder where you installed the Demoshop, by executing “cd demoshop” terminal command:
    C:\Users\voronin>cd demoshop
  3. To make sure you use the most recent version of Demoshop, run the following commands:
    docker-compose down
    docker volume rm app-sync
    docker volume create app-sync
    docker-compose up -d
  4. Finally, to start the demoshop, run this command:
    docker-compose up

Development With Docker Solution (docker-sync)

To develop with Docker solution, do the following:

  1. Enable Windows subsytem for Linux:
    • Click on Start icon, go to Control Panel -> Progarms->Programs and Featurs.
    • Select Turn Windows features on and off in the left menu tab.
    • Check Windows Subsystem for Linux (beta) checkbox.

  2. Make sure the Developer mode is enabled:
    • Click on Start icon, go to Settings->For Developers.
    • Enable the Developer mode, if it is disabled.
  3. Install Bash for Windows:
  4. Open command prompt and type lxrun /install. If bash for windows was already installed before the creators update, you may need to re-install it to get the latest distro.

  5. Launch and update Ubuntu:
    • Bash on Ubuntu Windows is now an app on your system. Launch it
    • Update the OS. Run the following commands:
      sudo apt-get update
      sudo apt-get upgrade			
  6. Install Docker:

    Follow these instructions to install Docker in WSL bash:

    Note that Docker server doesn't work on WSL (Windows subsystem for Linux) - we will expose Docker for Windows to WSL later.

  7. Install Docker Compose:

    Run the following command in the command line:

    sudo apt install docker-compose

    Or if that does not work, follow these instructions in WSL bash:
  8. Install Ruby and Ruby-dev:

    Run the following command:

    sudo apt-get install ruby ruby-dev

  9. Install docker-sync:

    Run the following command:

    sudo gem install docker-sync				

  10. Set your docker host as an ENV variable:

    Add export DOCKER_HOST=tcp:// to your ~/.bashrc file of WLS.

    In Docker for Windows settings check Expose daemon on tcp://localhost:2375 without TLS to expose docker to WSL.
  11. Install Unison:

    Run the following commands:

    sudo apt-get install ocaml make emacs
    tar xvf 2.48.4.tar.gz
    cd unison-2.48.4
    make UISTYLE=text
    sudo cp src/unison /usr/local/bin/unison
    sudo cp src/unison-fsmonitor /usr/local/bin/unison-fsmonitor
  12. Run the Docker containers with docker-sync:

    Put the docker-sync.yml ( in the your `demoshop` folder (where the docker-compose.yml is located). You now have a working version of docker-sync via the unison strategy. In your home directory in WSL you can link your projects from windows (/mnt/c/blah/blah/) and run docker-sync or docker-sync-stack. The rest of your workflow should be the same as before in either cmd or powershell, or some other windows terminal.

    Run these commands:

    cd /mnt/c/Users/admin/demoshop
    docker-compose up -d
    docker-sync start

If you need to make changes in docker-sync configuration, do not forget to start the following command before restarting the docker-sync process: docker-sync clean

Last review date: Jan. 22nd, 2018