Docker Install Prerequisites - MacOS

This document describes install prerequisites for MacOS.

Minimum System Requirements

Before proceeding, please review the minimum system requirements in the table:

System Requirement Additional Details
vCPU: 2 This is a minimum requirement. The value can be higher than 2. A lower value is not sufficient for running the application.
RAM: 4GB This is a minimum requirement. The value can be higher than 4GB. A lower value is not sufficient for installation purposes.

Swap: 2GB

This is a minimum requirement. The value can be higher than 2GB. A lower value is not sufficient for installation purposes.

1. Install Docker

  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, so you can close the Log in with your Docker ID window.

2. Enable Buildkit

Go to → Preferences → Daemon → Advanced and add the following:

{
  ...
  "features" : {
    "buildkit" : true
  },
  "experimental" : true
}

3. Update Memory and Swap Limits

  1. Go to → Preferences → Advanced.
  2. Set Memory limit to > 4Gb .
  3. Set Swap limit to > 2Gb.
  4. Apply the changes and Restart.

You can set smaller Memory and Swap limit values, however, make sure to change the default values.

4. Install or Update Docker-sync

This step is required if you want to run Spryker in development mode.

Install or update Docker-sync. The following command is used for both:

sudo gem install docker-sync

See also:

Last review date: Aug 06, 2019