From 0a76df591620814706a766415ca48d76652c80ff Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Wed, 3 Jun 2026 09:40:49 +0200 Subject: [PATCH 1/6] clustering_with_ddev: install Elasticsearch 7 instead of 9 --- .../clustering/clustering_with_ddev.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md index b1cbdcb2c2e..815ab3eaa5b 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md +++ b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md @@ -160,12 +160,15 @@ A [search engine](search_engines.md) can be added to the cluster. The following sequence of commands: 1. Adds the Elasticsearch container -2. Sets Elasticsearch as the search engine -3. Restarts the DDEV cluster and clears application cache -4. Injects the schema and reindexes the content +2. Sets the Elasticsearch version to 7 (default is 9 which is not supported; for version 8, also use `ibexa/elasticsearch8` package) +3. Sets Elasticsearch as the search engine +4. Restarts the DDEV cluster and clears application cache +5. Injects the schema and reindexes the content ```bash ddev add-on get ddev/ddev-elasticsearch +ddev dotenv set .ddev/.env.elasticsearch --elasticsearch-docker-image=elasticsearch:7.16.2 +cp .ddev/elasticsearch/docker-compose.elasticsearch7.yaml .ddev/ ddev config --web-environment-add SEARCH_ENGINE=elasticsearch ddev config --web-environment-add ELASTICSEARCH_DSN=http://elasticsearch:9200 ddev restart From d2ef8c427a59999c4fbfdf0f4d0bdde162da933f Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Wed, 3 Jun 2026 09:59:41 +0200 Subject: [PATCH 2/6] Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> --- .../clustering/clustering_with_ddev.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md index 815ab3eaa5b..8d766821075 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md +++ b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md @@ -160,7 +160,7 @@ A [search engine](search_engines.md) can be added to the cluster. The following sequence of commands: 1. Adds the Elasticsearch container -2. Sets the Elasticsearch version to 7 (default is 9 which is not supported; for version 8, also use `ibexa/elasticsearch8` package) +2. Sets the Elasticsearch version to 7 (default is 9 which is not supported, 8 is supported with the `ibexa/elasticsearch8` package) 3. Sets Elasticsearch as the search engine 4. Restarts the DDEV cluster and clears application cache 5. Injects the schema and reindexes the content From 78c184f1ebd0030d1a54494d94d3d37c8c291468 Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Tue, 21 Jul 2026 12:15:58 +0200 Subject: [PATCH 3/6] Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> --- .../clustering/clustering_with_ddev.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md index 8d766821075..3eb1e0a256e 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md +++ b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md @@ -160,14 +160,14 @@ A [search engine](search_engines.md) can be added to the cluster. The following sequence of commands: 1. Adds the Elasticsearch container -2. Sets the Elasticsearch version to 7 (default is 9 which is not supported, 8 is supported with the `ibexa/elasticsearch8` package) +2. Sets the Elasticsearch version to 7 (default is 9 which is not supported, 8 is supported with the `ibexa/elasticsearch8` package) - a full version number is required, see [Elasticsearch Docker image](https://hub.docker.com/_/elasticsearch) 3. Sets Elasticsearch as the search engine 4. Restarts the DDEV cluster and clears application cache 5. Injects the schema and reindexes the content ```bash ddev add-on get ddev/ddev-elasticsearch -ddev dotenv set .ddev/.env.elasticsearch --elasticsearch-docker-image=elasticsearch:7.16.2 +ddev dotenv set .ddev/.env.elasticsearch --elasticsearch-docker-image=elasticsearch:7.17.14 cp .ddev/elasticsearch/docker-compose.elasticsearch7.yaml .ddev/ ddev config --web-environment-add SEARCH_ENGINE=elasticsearch ddev config --web-environment-add ELASTICSEARCH_DSN=http://elasticsearch:9200 From 298b73137b1267d2c28a469d97455071b58f7950 Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Fri, 7 Aug 2026 09:36:01 +0200 Subject: [PATCH 4/6] clustering_with_ddev: link to install_elasticsearch.md --- .../clustering/clustering_with_ddev.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md index d03017eeaf1..2f7573e4697 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md +++ b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md @@ -157,7 +157,9 @@ A [search engine](search_engines.md) can be added to the cluster. ### Elasticsearch -The following sequence of commands: +The installation of Elasticsearch within a DDEV stack is an adaptation of the [on-premise installation](install_elasticsearch.md) procedure using the [`ddev/ddev-elasticsearch` add-on](https://addons.ddev.com/addons/ddev/ddev-elasticsearch) + +For example, the following sequence of commands: 1. Adds the Elasticsearch container 2. Sets the Elasticsearch version to 7 (default is 9 which is not supported, 8 is supported with the `ibexa/elasticsearch8` package) - a full version number is required, see [Elasticsearch Docker image](https://hub.docker.com/_/elasticsearch) From 1f9c50c7b44873f264a501917c4dddfb1c0651fa Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Fri, 7 Aug 2026 13:50:35 +0200 Subject: [PATCH 5/6] clustering_with_ddev: link to install_solr.md --- .../clustering/clustering_with_ddev.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md index 2f7573e4697..9f6ec9ceb29 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md +++ b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md @@ -157,7 +157,7 @@ A [search engine](search_engines.md) can be added to the cluster. ### Elasticsearch -The installation of Elasticsearch within a DDEV stack is an adaptation of the [on-premise installation](install_elasticsearch.md) procedure using the [`ddev/ddev-elasticsearch` add-on](https://addons.ddev.com/addons/ddev/ddev-elasticsearch) +The installation of Elasticsearch within a DDEV stack is an adaptation of the [on-premise installation](install_elasticsearch.md) procedure using the [`ddev/ddev-elasticsearch` add-on](https://addons.ddev.com/addons/ddev/ddev-elasticsearch). For example, the following sequence of commands: @@ -197,7 +197,9 @@ See [Elasticsearch REST API reference](https://www.elastic.co/guide/en/elasticse ### Solr -The following sequence of commands: +The installation of Solr within a DDEV stack is an adaptation of the [on-premise installation](install_solr.md) procedure using the [`ddev/ddev-solr` add-on](https://addons.ddev.com/addons/ddev/ddev-solr). + +For example, the following sequence of commands: 1. Adds the Solr container 2. Sets Solr as the search engine From fdde30cf5a091155248e167b2056beb9cab561fe Mon Sep 17 00:00:00 2001 From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Date: Mon, 10 Aug 2026 16:14:46 +0200 Subject: [PATCH 6/6] clustering_with_ddev.md: Fixes from 5.0 --- .../clustering/clustering_with_ddev.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md index 9f6ec9ceb29..20fd8b6dfc9 100644 --- a/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md +++ b/docs/infrastructure_and_maintenance/clustering/clustering_with_ddev.md @@ -137,7 +137,7 @@ For more information on topics such as available configurations, command lines, ### Fastly -For Fastly (as for [[[= product_name_connect =]]](https://doc.ibexa.co/projects/connect/en/latest/)), the instance must be visible from Internet. +For Fastly (as for [[[= product_name_connect =]]]([[= connect_doc =]]/)), the instance must be visible from Internet. To use [ngrok](https://ngrok.com/) alongside [`ddev share`](https://docs.ddev.com/en/stable/users/topics/sharing/#using-ddev-share-easiest) is probably the easiest way to achieve this. @@ -185,11 +185,11 @@ For example, the `ddev exec curl -s "http://elasticsearch:9200/_count"` command For more information on topics such as memory management, see [ddev/ddev-elasticsearch README](https://github.com/ddev/ddev-elasticsearch). -See [Elasticsearch REST API reference](https://www.elastic.co/guide/en/elasticsearch/reference/current/rest-apis.html) for more request options, like, for example: +See [Elasticsearch REST API reference](https://www.elastic.co/docs/reference/elasticsearch/rest-apis) for more request options, like, for example: -- [`_count`](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-count.html), as seen above -- [`_cluster/health`](https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-health.html) (don't mind the "yellow" status which is normal in the absence of replicas in the DDEV container) -- [`_search?size=0"`](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html), which is another way to get document count +- [`_count`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-count), as seen above +- [`_cluster/health`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cluster-health) (don't mind the "yellow" status which is normal in the absence of replicas in the DDEV container) +- [`_search?size=0"`](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search), which is another way to get document count !!! tip @@ -225,9 +225,9 @@ You can now check whether Solr works. For example, the `ddev exec curl -s http://solr:SolrRocks@solr:8983/api/cores/` command: - - checks whether the `web` server can access the `solr` server - - checks whether `collection1` exists and its status - - displays `collection1`'s `numDocs` that shouldn't be zero if indexing worked correctly +- checks whether the `web` server can access the `solr` server +- checks whether `collection1` exists and its status +- displays `collection1`'s `numDocs` that shouldn't be zero if indexing worked correctly You can access the Solr admin UI from the host by: @@ -250,7 +250,7 @@ In the following examples: ### Install Redis or Valkey DDEV supports multiple Redis-compatible implementation, including Redis itself and Valkey. -You can switch between them using the `ddev redis-backend ` command after adding the `ddev/ddev-redis` add-on. +You can switch between them using the `ddev redis-backend ` command after adding the `ddev/ddev-redis` add-on. For example, you can switch to Valkey by running `ddev add-on get ddev/ddev-redis; ddev redis-backend valkey/valkey:9`. For more information, see [Swappable Redis backends](https://github.com/ddev/ddev-redis?tab=readme-ov-file#swappable-redis-backends) in DDEV's `dddev-redis` add-on documentation.