Requirements

Installation Summary

Installing Reward is relatively easy. You can just go to the Reward downloads page and get the binary for your platform. You should then extract it to any directory and add that directory to your system’s PATH.

But if you prefer, you can use package managers as well. See in the Downloading Reward section of this page. But there are some requirements that you need to meet before you can install Reward.

Common requirements

  • Docker CE 20.10.2 or later

  • docker compose version 2.0 or later is required. It is currently a part of the Docker Desktop package.

    Warning

    If you keep getting the docker api is unreachable error message, check the FAQ.

Additional requirements (macOS only)

  • Mutagen 0.13.1 or later is required for environments leveraging sync sessions on macOS. Reward will attempt to install mutagen via brew if not present on macOS.

    Warning

    By default Docker Desktop allocates 2GB memory. This leads to extensive swapping, killed processes and extremely high CPU usage during some Magento actions, like for example running sampledata:deploy and/or installing the application. It is recommended to assign at least 6GB RAM to Docker Desktop prior to deploying any Magento environments on Docker Desktop. This can be corrected via Preferences -> Resources -> Advanced -> Memory. While you are there, it wouldn’t hurt to let Docker have the use of a few more vCPUs (keep it at least 4 less than the maximum CPU allocation however to avoid having macOS contend with Docker for use of cores)

Additional requirements (Windows only)

  • Mutagen 0.13.1 or later is required for environments leveraging sync sessions on Windows. Reward will attempt to install mutagen to the same path it is installed.

  • YogaDNS 1.16 Beta or later is required for using dnsmasq as a local DNS resolver on Windows.

    Warning

    On Windows with WSL2 docker can use unlimited memory and CPU. It is possible and suggested to configure limitations to WSL. You can create a .wslconfig file to your user’s home directory with the following content.

    C:\Users\<yourUserName>\.wslconfig

    [wsl2]
memory=8GB
processors=4

    If you configured this you will have to restart WSL with the following PowerShell command:

    Restart-Service LxssManager

    See further instructions here: https://docs.microsoft.com/en-us/windows/wsl/wsl-config#wsl-2-settings