You are browsing the documentation for version 4.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Set up Environment for OroPlatform Based Application on Windows Subsystem for Linux (WSL) 2

This guide demonstrates how to set up Docker and Symfony Server development stack for Oro applications on Windows 10, version 1903 or higher.

Environment Setup

  1. Install Ubuntu 20.04 LTS from the Microsoft Store that will be used with WSL 2.

  2. Install Windows Terminal. It’s not required to use a Windows Terminal but we recommend using it as it comes with the built-in WSL integration.

  3. Install Docker Desktop for Windows.

  4. Enable Docker Desktop WSL 2 backend for the Ubuntu 20.04 LTS distribution that you installed at step 1.

  5. Log into Ubuntu 20.04 LTS using Windows Terminal. All the below commands will be executed in it.

  6. Install PHP 7.4 with all required extensions to Ubuntu 20.04 LTS:

    sudo apt install software-properties-common
    sudo add-apt-repository -y ppa:ondrej/php
    sudo apt update
    sudo apt -y install php7.4 php7.4-fpm php7.4-cli php7.4-pdo php7.4-mysqlnd php7.4-xml php7.4-soap php7.4-gd php7.4-zip php7.4-intl php7.4-mbstring php7.4-opcache php7.4-curl php7.4-bcmath php7.4-ldap php7.4-pgsql php7.4-dev
  7. If you going to use an Enterprise Edition of the application, install and enable the mongodb php extension:

    sudo pecl channel-update
    sudo pecl install mongodb
    sudo echo | sudo tee -a /etc/php/7.4/fpm/php.ini
    sudo echo | sudo tee -a /etc/php/7.4/cli/php.ini
  8. Install Node.js 14:

    sudo apt -y install curl dirmngr apt-transport-https lsb-release ca-certificates
    curl -sL | sudo -E bash -
    sudo apt -y install nodejs
  9. Install Composer:

    php -r "copy('', 'composer-setup.php');" && php composer-setup.php
    php -r "unlink('composer-setup.php');"
    sudo mv composer.phar /usr/bin/composer
  10. Install Symfony Server:

sudo apt -y install libnss3-tools
wget -O - | bash
echo 'PATH="$HOME/.symfony/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
symfony server:ca:install


You can also enable TLS, but as Symfony Server does not automate certificate installation for WSL on Windows, you will have to copy the generated certificate manually from the /usr/local/share/ca-certificates/ folder to the host filesystem and install it manually to your web browser.

  1. Restart the terminal and web browser to get them ready.

What’s Next