Skip to content

Latest commit

 

History

History
71 lines (44 loc) · 3.13 KB

01-installing-docker-prerequisites-on-macos.md

File metadata and controls

71 lines (44 loc) · 3.13 KB

Installing Docker prerequisites on MacOS

This article describes Docker installation prerequisites for MacOS.

Minimum system requirements

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.

Install and configure a Docker manager

You can run Spryker in Docker using Docker Desktop or OrbStack. Docker Desktop is a free default tool, but OrbStack works faster with intel-based Macs.

Install Docker Desktop

  1. Download and install Docker Desktop (Mac).

{% info_block infoBox %}

Signup for Docker Hub is not required.

{% endinfo_block %}

  1. Accept the privilege escalation request "Docker Desktop needs privileged access.".

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

  3. In the General section of Preferences, click the Use Docker Compose V2 checkbox.

  4. Set recommended 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.

Install OrbStack

Download and install OrbStack.

To migrate from Docker Desktop to OrbStack, see Migrate from Docker to OrbStack. To run Docker Desktop and OrbStack side-by-side and switch between them, see Side-by-side .

Install Mutagen for development mode

If you are going to run Spryker in 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 Chossing an installation mode to choose an installation mode. If you've already selected an installation mode, follow one of the guides below: