Skip to content

Document Elasticsearch v9 support and v7.17 deprecation #8849

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lieut-data wants to merge 2 commits into
base: master
Choose a base branch
from
+13 −5
Open

Document Elasticsearch v9 support and v7.17 deprecation #8849

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d71578b
Document Elasticsearch v9 support and v7.17 deprecation
lieut-data Apr 2, 2026
9ecfc75
Merge branch 'master' into support-elasticsearch-v9
lieut-data Apr 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions source/administration-guide/scale/elasticsearch-setup.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Set up Elasticsearch

We highly recommend that you set up Elasticsearch server on a dedicated machine separate from the Mattermost Server.

1. Download and install the latest release of `Elasticsearch v8 <https://www.elastic.co/guide/en/elasticsearch/reference/8.15/install-elasticsearch.html>`_, or `Elasticsearch v7.17+ <https://www.elastic.co/guide/en/elasticsearch/reference/7.17/install-elasticsearch.html>`_. See the Elasticsearch documentation for installation details.
1. Download and install the latest release of `Elasticsearch v9 <https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html>`_ or `Elasticsearch v8 <https://www.elastic.co/guide/en/elasticsearch/reference/8.19/install-elasticsearch.html>`_. See the Elasticsearch documentation for installation details.

2. Set up Elasticsearch with ``systemd`` by running the following commands:

Expand Down Expand Up @@ -43,7 +43,7 @@ We highly recommend that you set up Elasticsearch server on a dedicated machine

6. In this file, replace the ``network.host`` value of ``_eth0_`` with your network interface name, and save your changes.

7. When using Elasticsearch v8, ensure you set ``action.destructive_requires_name`` to ``false`` in ``elasticsearch.yml`` to allow for wildcard operations to work.
7. Ensure you set ``action.destructive_requires_name`` to ``false`` in ``elasticsearch.yml`` to allow for wildcard operations to work.
Comment thread
lieut-data marked this conversation as resolved.

8. Restart Elasticsearch by running the following commands:

Expand Down
12 changes: 10 additions & 2 deletions source/administration-guide/scale/enterprise-search.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,9 +37,17 @@ Supported paths

Review the following support paths for enterprise search based on the version you're using:

.. tab:: Elasticsearch v9

`Elasticsearch v9 <https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-intro.html>`__ is supported from Mattermost v11.7. We recommend upgrading to Elasticsearch v9 for the latest features and security updates. See the `Elasticsearch upgrade <https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html>`_ documentation for upgrade details, and see the :doc:`Elasticsearch setup </administration-guide/scale/elasticsearch-setup>` documentation for details on configuring your Mattermost deployment to use Elasticsearch.

.. tab:: Elasticsearch v8

`Elasticsearch v8 <https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-intro.html>`__ is supported from Mattermost v9.11. While Mattermost supports Elasticsearch v7.17+, we recommend upgrading your Elasticsearch v7 instance to v8.x. See the `Elasticsearch upgrade <https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html>`_ documentation for upgrade details, and see the :doc:`Elasticsearch setup </administration-guide/scale/elasticsearch-setup>` documentation for details on configuring your Mattermost deployment to use Elasticsearch.
`Elasticsearch v8 <https://www.elastic.co/guide/en/elasticsearch/reference/8.19/elasticsearch-intro.html>`__ is supported from Mattermost v9.11. We recommend upgrading to Elasticsearch v9 for the latest features and security updates. See the `Elasticsearch upgrade <https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html>`_ documentation for upgrade details, and see the :doc:`Elasticsearch setup </administration-guide/scale/elasticsearch-setup>` documentation for details on configuring your Mattermost deployment to use Elasticsearch.

.. note::

Elasticsearch v7.17 is no longer supported as of Mattermost v11.7. If you're still using Elasticsearch v7, you must upgrade to Elasticsearch v8 or v9.

.. tab:: AWS OpenSearch Service

Expand All @@ -49,7 +57,7 @@ Review the following support paths for enterprise search based on the version yo

.. tab:: AWS Elasticsearch v7.10.x

If you're using Elasticsearch v7.10.x under AWS’s managed services, you can't use newer Elasticsearch clients like the v8 client without changing backend infrastructure. If you're using AWS Elasticsearch v7.10.x, you must `upgrade to AWS OpenSearch <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/version-migration.html>`_ for future compatibility.
If you're using Elasticsearch v7.10.x under AWS’s managed services, you can't use newer Elasticsearch clients like the v8 or v9 client without changing backend infrastructure. If you're using AWS Elasticsearch v7.10.x, you must `upgrade to AWS OpenSearch <https://docs.aws.amazon.com/opensearch-service/latest/developerguide/version-migration.html>`_ for future compatibility.

The migration path from Elasticsearch v7.10.x to OpenSearch has been designed to be straightforward, minimizing effort:

Expand Down
2 changes: 1 addition & 1 deletion source/deployment-guide/software-hardware-requirements.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -232,5 +232,5 @@ For Enterprise Edition deployments with a multi-server setup, we highly recommen

- Prometheus to track system health of your Mattermost deployment, through :doc:`performance monitoring feature </administration-guide/scale/deploy-prometheus-grafana-for-performance-monitoring>` available in Mattermost Enterprise.
- Grafana to visualize the system health metrics collected by Prometheus with the :doc:`performance monitoring feature </administration-guide/scale/deploy-prometheus-grafana-for-performance-monitoring>`. Grafana 5.0.0 and later is recommended.
- Elasticsearch to support highly efficient database searches in a cluster environment. Elasticsearch v7.17+ is supported, and Elasticsearch v8.x or AWS OpenSearch is recommended from Mattermost v9.11. :doc:`Learn more </administration-guide/scale/enterprise-search>`.
- Elasticsearch to support highly efficient database searches in a cluster environment. Elasticsearch v8.x and v9.x are supported, and Elasticsearch v9.x or AWS OpenSearch is recommended. :doc:`Learn more </administration-guide/scale/enterprise-search>`.
Comment thread
lieut-data marked this conversation as resolved.
- AWS S3 or any S3-compatible service. Mattermost is compatible with object storage systems which implement the S3 API. You can also use local storage or a network drive using NFS. Learn more about file storage configuration options :ref:`in our documentation <administration-guide/configure/environment-configuration-settings:file storage>`.
Loading