Elasticsearch 8 support by mnocon · Pull Request #3002 · ibexa/documentation-developer

mnocon · 2026-01-13T15:16:21Z

Doc for https://github.com/ibexa/elasticsearch/pull/70

Target: v5 only

github-actions · 2026-01-13T15:25:19Z

Preview of modified files

Preview of modified Markdown:

docs/search/search_engines/elasticsearch/configure_elasticsearch.md

micszo

Thanks for covering the alternative!

barw4 · 2026-01-15T09:14:06Z

docs/search/search_engines/elasticsearch/configure_elasticsearch.md

 ```

-For more information and a list of available choices, see [Connection pool](https://www.elastic.co/guide/en/elasticsearch/client/php-api/7.x/connection_pool.html).
+For more information and a list of available choices, see [Node pool](https://www.elastic.co/docs/reference/elasticsearch/clients/php/node_pool).


Shouldn't we put the link to 7x and 8x clients here?

julitafalcondusza

Please check my comments.

docs/update_and_migration/from_5.0/update_from_5.0.md

docs/search/search_engines/elasticsearch/configure_elasticsearch.md

Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com>

dabrt · 2026-01-15T09:50:52Z

docs/search/search_engines/elasticsearch/configure_elasticsearch.md

+The node pool manages the list of active nodes, which can change over time due to connectivity issues, host malfunction, or when you add new nodes to the cluster to increase performance.

-You can change the default setting with the following key:
+By default, Elasticsearch 8 uses `SimpleNodePool` with `RoundRobin` selector and `NoResurrect` strategy.


I'd put it differently, because users can opt for either of the supported versions. Something along the lines of:
"In installations running Elasticsearch 8.18+, the default configuration uses SimpleNodePool with a RoundRobin selector and a NoResurrect strategy."

At the same time, I wouldn't remove information that discusses 7.16.2+ configuration, but have both.

Unless of course we want to adamantly say "you must use elastic 8" or at least "Ibexa strongly recommends that you use elastic 8" in all those places where two versions are mentioned, followed by "for 7.16.2+ configuration, refer to our documentation for the v.4.6.x release" (in requirements and a note in install elasticsearch)

Even if you decide to use Elasticsearch 7 (which we won't recommend anymore), you cannot use the existing configuration - please see the update instructions, the old configuration is deprecated and does nothing.

Regardless of Elasticsearch version, you have to use the "node pool" settings - even when staying on Elasticsearch 7

It's all clear now

docs/search/search_engines/elasticsearch/configure_elasticsearch.md

…version

…ch.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>

@mnocon

* Added Redis 8+ and Valkey 9+ support (#2996) * Added Redis 8+, 9+ and Valkey 9+ support * Removed Redis 9 * Update docs/getting_started/requirements.md * Apply suggestions from code review * Added mention about messenger tables (#3003) * Removed warning about Safari * Elasticsearch 8 support (#3002) * Adjusted the doc * Selfreview * Apply suggestion from @mnocon * Reworked the doc: api_key examples and ES7 is still supported * Apply suggestions from Doc review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * Added suggestion that updating is recommended - and removed explicit version * Update docs/search/search_engines/elasticsearch/configure_elasticsearch.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Improved wording --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Mention that the new configuration is for both ES 7 and 8 (#3013) * PHP API Ref HTML * REST API Ref HTML * Release notes for 5.0.5 (#3011) * Adjusted the doc * Selfreview * Apply suggestion from @mnocon * Reworked the doc: api_key examples and ES7 is still supported * Apply suggestions from Doc review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * Release notes for 5.0.5 * Added suggestion that updating is recommended - and removed explicit version * Update docs/search/search_engines/elasticsearch/configure_elasticsearch.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Removed broken links * Removed broken fragment * Bumped mkdocs variable * Fixed image * Removed big TODO headers * Fixes * Adjusted headers * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Added links to REST API ref --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: ibexa-workflow-automation-1[bot] <ibexa-workflow-automation-1[bot]@users.noreply.github.com>

@mnocon

* Added Redis 8+ and Valkey 9+ support (#2996) * Added Redis 8+, 9+ and Valkey 9+ support * Removed Redis 9 * Update docs/getting_started/requirements.md * Apply suggestions from code review * Added mention about messenger tables (#3003) * Removed warning about Safari * Elasticsearch 8 support (#3002) * Adjusted the doc * Selfreview * Apply suggestion from @mnocon * Reworked the doc: api_key examples and ES7 is still supported * Apply suggestions from Doc review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * Added suggestion that updating is recommended - and removed explicit version * Update docs/search/search_engines/elasticsearch/configure_elasticsearch.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Improved wording --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Mention that the new configuration is for both ES 7 and 8 (#3013) * PHP API Ref HTML * REST API Ref HTML * Release notes for 5.0.5 (#3011) * Adjusted the doc * Selfreview * Apply suggestion from @mnocon * Reworked the doc: api_key examples and ES7 is still supported * Apply suggestions from Doc review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * Release notes for 5.0.5 * Added suggestion that updating is recommended - and removed explicit version * Update docs/search/search_engines/elasticsearch/configure_elasticsearch.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Removed broken links * Removed broken fragment * Bumped mkdocs variable * Fixed image * Removed big TODO headers * Fixes * Adjusted headers * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Added links to REST API ref --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: ibexa-workflow-automation-1[bot] <ibexa-workflow-automation-1[bot]@users.noreply.github.com>

Adjusted the doc

e6010bd

Selfreview

77a32fc

mnocon added the Needs DEV review label Jan 13, 2026

mnocon commented Jan 13, 2026

View reviewed changes

docs/search/search_engines/elasticsearch/configure_elasticsearch.md Outdated Show resolved Hide resolved

Apply suggestion from @mnocon

56e7e5a

mnocon marked this pull request as ready for review January 14, 2026 08:16

mnocon requested review from barw4 and micszo January 14, 2026 08:23

micszo approved these changes Jan 14, 2026

View reviewed changes

mnocon force-pushed the elasticsearch-8 branch from e91a23b to f263746 Compare January 15, 2026 07:14

Reworked the doc: api_key examples and ES7 is still supported

6463dd5

mnocon force-pushed the elasticsearch-8 branch from f263746 to 6463dd5 Compare January 15, 2026 07:16

micszo approved these changes Jan 15, 2026

View reviewed changes

mnocon added Needs DOC review and removed Needs DEV review labels Jan 15, 2026

mnocon requested a review from a team January 15, 2026 09:06

ibexa-workflow-automation-1 bot requested review from adriendupuis, dabrt and julitafalcondusza and removed request for a team January 15, 2026 09:06

mnocon added the Wait with merge PRs that shouldn't be merged instantly label Jan 15, 2026

barw4 approved these changes Jan 15, 2026

View reviewed changes

julitafalcondusza requested changes Jan 15, 2026

View reviewed changes

docs/update_and_migration/from_5.0/update_from_5.0.md Outdated Show resolved Hide resolved

docs/update_and_migration/from_5.0/update_from_5.0.md Show resolved Hide resolved

docs/search/search_engines/elasticsearch/configure_elasticsearch.md Outdated Show resolved Hide resolved

Apply suggestions from Doc review

e8edbcd

Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com>

dabrt requested changes Jan 15, 2026

View reviewed changes

julitafalcondusza approved these changes Jan 15, 2026

View reviewed changes

mnocon changed the base branch from 5.0 to release-5.0.5 January 15, 2026 10:56

mnocon added 2 commits January 15, 2026 11:00

Added suggestion that updating is recommended - and removed explicit …

631d369

…version

Merge branch 'release-5.0.5' into elasticsearch-8

738a63a

Update docs/search/search_engines/elasticsearch/configure_elasticsear…

984972c

…ch.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>

mnocon requested a review from dabrt January 15, 2026 11:10

Improved wording

d2e117e

dabrt approved these changes Jan 15, 2026

View reviewed changes

mnocon merged commit fcddb06 into release-5.0.5 Jan 15, 2026
7 checks passed

mnocon deleted the elasticsearch-8 branch January 15, 2026 11:23

mnocon mentioned this pull request Jan 15, 2026

Release 5.0.5 #3012

Merged

dabrt removed Needs DOC review Wait with merge PRs that shouldn't be merged instantly labels Jan 30, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Elasticsearch 8 support#3002

Elasticsearch 8 support#3002
mnocon merged 9 commits intorelease-5.0.5from
elasticsearch-8

mnocon commented Jan 13, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 13, 2026

Uh oh!

Uh oh!

micszo left a comment

Uh oh!

barw4 Jan 15, 2026 •

edited

Loading

Uh oh!

julitafalcondusza left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dabrt Jan 15, 2026

Uh oh!

mnocon Jan 15, 2026

Uh oh!

dabrt Jan 15, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

mnocon commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 13, 2026

Preview of modified files

Uh oh!

Uh oh!

micszo left a comment

Choose a reason for hiding this comment

Uh oh!

barw4 Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

julitafalcondusza left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dabrt Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

mnocon Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

dabrt Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

mnocon commented Jan 13, 2026 •

edited

Loading

barw4 Jan 15, 2026 •

edited

Loading