Installing Docker prerequisites on MacOS

Last updated:
Edit on GitHub

This document describes the prerequisites for installing Spryker in Docker on MacOS.

System requirements for installing Spryker with Docker

Review the system and software requirements in the table and configure them using the following instructions.

REQUIREMENT VALUE OR VERSION
Docker 18.09.1 or higher
Docker Compose 2.0 or higher
vCPU 4 or more
RAM 4GB or more
Swap 2GB or more

Installing and configuring required software

Follow the steps to install and configure the required software:

  1. Download and install Docker Desktop (Mac).

  2. Accept the privilege escalation request “Docker Desktop needs privileged access.”.

Signup for Docker Hub is not required.

  1. In the Docker Desktop, go to preferences by selecting the gear in the top right corner.

  2. In the General section of Preferences, select the Use Docker Compose V2 checkbox.

  3. Update Memory and Swap Limits:

    1. Go to Resources > ADVANCED.
    2. Set CPUs: to “4” or higher.
    3. Set Memory: to “4.00 GB” or higher.
    4. Set Swap: to “2.00 GB” or higher.
    5. Set the desired Disk image size:.
    6. Select the desired Disk image location.
    7. Select Apply & Restart.

You can select lower Memory: and Swap: values than those provided in the instructions. However, the default ones won’t be sufficient to run the application.

  1. Development mode: Install or update Mutagen and Mutagen Compose to the latest version:
brew list | grep mutagen | xargs brew remove && brew install mutagen-io/mutagen/mutagen mutagen-io/mutagen/mutagen-compose && mutagen daemon stop && mutagen daemon start

Next steps

See Choosing an installation mode to choose an installation mode.

If you’ve already selected an installation mode, follow one of the guides below: