How to install Elastic-Suite Gally on macOS using Docker

To run Gally on macOS using Docker, you can follow the steps outlined here.

Before executing step 4 make up, I recommend applying the below changes.

One particular issue I encountered was with the gally-php container, which I reported on Elastic-Suite GitHub. For now, it’s only a quick and temporary workaround to address the problem.

The issue I faced was related to the setfacl command not being supported on macOS.

2023-06-17 01:12:08 setfacl: var/cache: Not supported
2023-06-17 01:12:08 setfacl: var/log: Not supported

To resolve this, I made updates to the api/docker/php/docker-entrypoint.sh file by replacing the following sections:

setfacl -R -m u:www-data:rwX -m u:"$(whoami)":rwX var
setfacl -dR -m u:www-data:rwX -m u:"$(whoami)":rwX var

setfacl -R -m u:www-data:rX -m u:"$(whoami)":rwX config/jwt
setfacl -dR -m u:www-data:rX -m u:"$(whoami)":rwX config/jwt

with

chown -R www-data var
chmod -R 777 var

and

chown -R www-data config/jwt
chmod -R 777 config/jwt

Note that this is a temporary workaround to enable you to quickly test this amazing application.

After executing step 4 make up while setting up Gally, I encountered a separate issue (not related to macOS) with gally-pwa. The error message displayed was as follows:

info There appears to be trouble with your network connection. Retrying…

To resolve this issue, if you also face it, go to your gally-pwa terminal and run:

$ yarn cache clean

yarn cache clean command on gally-pwa container

Once you have completed these steps, you should be able to proceed with the rest of the process without any further issues. Now, you can continue to step 5 make fixtures_load.