Important

You are browsing upcoming documentation for version 7.1 of OroCommerce, scheduled for release in 2027. Read the documentation for 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.5, Composer and Node.js 24:

    brew install php@8.5 composer node
echo 'export PATH="/usr/local/opt/php@8.5/bin:$PATH" \nexport PATH="/usr/local/opt/php@8.5/sbin:$PATH" \nexport PATH="/usr/local/opt/node@20/bin:$PATH"' >> ~/.bash_profile

  4. Install PNPM 10 Using NPM:

    npm install -g pnpm@latest-10

  5. If you are going to use an Enterprise Edition of the application, install the mongodb php extension:

    brew tap shivammathur/extensions
brew install mongodb@8.5

  6. 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" >> $(brew --prefix)/etc/php/8.5/php.ini

  7. Install Symfony Server and enable TLS:

    brew install symfony-cli
symfony local:server:ca:install

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

What’s Next