You are browsing the documentation for version 4.2 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 Mac OS X

This guide demonstrates how to set up Docker and Symfony Server development stack for Oro applications on Mac OS X.

Environment Setup

  1. Install Homebrew package manager to manage all the required software from CLI:

    /bin/bash -c "$(curl -fsSL"
  2. Install Docker and start the Docker deamon:

    brew install --cask docker
    open /Applications/
  3. Install PHP 7.4, Composer, Node.js 14 and Docker Compose:

    brew install php@7.4 composer node@14 docker-compose
    echo 'export PATH="/usr/local/opt/php@7.4/bin:$PATH" \nexport PATH="/usr/local/opt/php@7.4/sbin:$PATH" \nexport PATH="/usr/local/opt/node@12/bin:$PATH"' >> ~/.bash_profile
  4. If you going to use an Enterprise Edition of the application, install and enable the mongodb php extension:

    pecl channel-update
    pecl install mongodb-1.9.1
    echo "extension=\"\"" >> /usr/local/etc/php/7.4/php.ini
  5. Configure PHP:

    echo "memory_limit = 2048M \nmax_input_time = 600 \nmax_execution_time = 600 \nrealpath_cache_size=4096K \nrealpath_cache_ttl=600 \nopcache.enable=1 \nopcache.enable_cli=0 \nopcache.memory_consumption=512 \nopcache.interned_strings_buffer=32 \nopcache.max_accelerated_files=32531 \nopcache.save_comments=1" >> /usr/local/etc/php/7.4/php.ini
  6. Install Symfony Server and enable TLS:

    curl -sS | bash
    echo 'export PATH="$HOME/.symfony/bin:$PATH"' >> ~/.bash_profile
    source ~/.bash_profile
    symfony local:server:ca:install
  1. Restart the terminal and web browser to get them ready.

What’s Next