Install Docker prerequisites on Windows with WSL2

Last updated:
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 (64bit) Pro, Enterprise, or Education (1607 Anniversary Update, Build 14393 or later).
BIOS Virtualization Enabled Typically, virtualization is enabled by default. Note that having the virtualization enabled is different from having Hyper-V enabled. You can check this setting in the Task Manager > Performance tab. For more details, see Virtualization must be enabled.
CPU SLAT-capable feature Enabled SLAT is CPU related feature. It is called Rapid Virtualization Indexing (RVI).
Docker 18.09.1 or higher
Docker Compose 2.0 or higher
RAM 16GB or more
Swap 4GB 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: