Install Docker prerequisites on Windows with WSL2

Edit on GitHub

This document describes the prerequisites for installing Spryker on Windows.

System requirements for installing Spryker

REQUIREMENT VALUE OR VERSION ADDITIONAL DETAILS
Windows 10 or 11 (64-bit) Pro, Enterprise, or Education editions (1607 Anniversary Update, Build 14393 or later).
BIOS Virtualization Enabled Usually enabled by default. This is different from Hyper-V. Check via Task Manager > Performance tab. See details.
CPU SLAT-capable Enabled SLAT (Second Level Address Translation), also known as Rapid Virtualization Indexing (RVI).
Docker 18.09.1 or higher
Docker Compose 2.0 or higher
RAM 16 GB or more
Swap 4 GB or more

Install and configure the required software

When running commands described in this document, use absolute paths. For example: mkdir /d/spryker && cd $_ or mkdir /c/Users/spryker && cd $_.

Follow the steps below to install and configure the required software with WSL2:

  1. Enable WSL2 and install Docker Desktop.

  2. In the General tab of the Docker Desktop settings, select Expose daemon on tcp://localhost:2375 without TLS.

  3. To save the settings, click Apply & Restart.

  4. Install Ubuntu 20.04.

  5. Run Ubuntu and update it:

sudo apt update && sudo apt dist-upgrade
  1. Exit Ubuntu and restart Windows.

You’ve installed and configured the required software.

Next steps

To choose an installation mode, see Choose an installation mode. If you’ve already selected an installation mode, follow one of the guides below: