Installing Docker prerequisites on MacOS

Edit on GitHub

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

Minimum system requirements

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 1.28 or 1.29
vCPU 2 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. Go to whale > Preferences > Command Line and Enable experimental features.

  2. Update Memory and Swap Limits:

    1. Go to whale > Preferences > 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. Click Apply & Restart.

You can set lower Memory: and Swap: limit values. However, the default limits won’t be sufficient to run the application, so make sure to increase them.

  1. Development mode: Install Mutagen:
brew install mutagen-io/mutagen/mutagen-beta

Next steps

See Chossing an installation mode to choose an installation mode. If you’ve already selected an installation mode, follow one of the guides below: