Important

We are updating the images for OroCommerce version 6.1 to align with the latest changes in the back-office design. During this transition, some images may still show older versions. Thank you for your patience as we work to update all visuals to reflect these changes.

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.4, Composer and Node.js 22:

    brew install php@8.4 composer node
echo 'export PATH="/usr/local/opt/php@8.4/bin:$PATH" \nexport PATH="/usr/local/opt/php@8.4/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.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/8.4/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