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 the updated 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.
Install Ubuntu 20.04 LTS from the Microsoft Store that will be used with WSL 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.
Install Docker Desktop for Windows.
Enable Docker Desktop WSL 2 backend for the Ubuntu 20.04 LTS distribution that you installed at step 1.
Log into Ubuntu 20.04 LTS using Windows Terminal. All the below commands will be executed in it.
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
If you going to use an Enterprise Edition of the application, install and enable the mongodb php extension:
sudo pecl channel-update pecl.php.net sudo pecl install mongodb sudo echo extension=mongodb.so | sudo tee -a /etc/php/7.4/fpm/php.ini sudo echo extension=mongodb.so | sudo tee -a /etc/php/7.4/cli/php.ini
Install Node.js 14:
sudo apt -y install curl dirmngr apt-transport-https lsb-release ca-certificates curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - sudo apt -y install nodejs
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php php -r "unlink('composer-setup.php');" sudo mv composer.phar /usr/bin/composer
Install Symfony Server:
sudo apt -y install libnss3-tools wget https://get.symfony.com/cli/installer -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.
- Restart the terminal and web browser to get them ready.
- Follow the recommendations
- Install the Oro Application via the Command-Line Interface
- For the development you can use the Visual Studio Code or PhpStorm with the built-in WSL integration.