Overview

You can use the same Elasticsearch container for local development which is also used for Beach in production. The only difference is that the Local Beach version is without password protection.

If you have a running Local Beach setup for your project, adding Elasticsearch is just a matter of adding the container configuration.

Add Elasticsearch to Docker Compose

Open the .localbeach.docker-compose.yaml file of your Local Beach project and add the following at the end of the file:

If you are using Elasticsearch in multiple Local Beach projects, you should also configure the Elasticsearch cluster name in your .localbeach.dist.env:

Configure Neos to use Elasticsearch

Next, you need to tell Neos where to find the Elasticsearch container. For example, if you are using Elasticsearch 2.x, the following configuration needs to go into your Configuration/Development/Beach/Instance/Settings.yaml:

You should now be able to use Elasticsearch in you Local Beach setup.

If something is going wrong, you may first want to check the settings (for example by running ./flow configuration:show --type Settings in your Local Beach shell) and then look for any errors in the container logs (using beach local:logs).