Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) 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 https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
    
  2. Install Docker with Docker Compose and start the Docker daemon:

    brew cask install docker
    open /Applications/Docker.app
    
  3. Install PHP 8.3, Composer and Node.js 20:

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

    pecl install mongodb
    echo "extension=\"mongodb.so\"" >> /usr/local/etc/php/8.2/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/8.2/php.ini
    
  6. Install Symfony Server and enable TLS:

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

What’s Next