Server

OpenSearch 2.x

Updated: April 28, 2026

Install the OpenSearch 2.x search client packages, then apply the same configuration steps as on Search setup for OpenSearch 1.x, using the opensearch2 property namespace.

In order to use an OpenSearch 2.x cluster, you need to install the nuxeo-search-client-opensearch2 and nuxeo-audit-opensearch2 packages.

If you want to set up an OpenSearch server that runs in the same JVM as the Nuxeo Platform's, you have to install explicitly the nuxeo-opensearch2-embed package. For production, you need to set up a Search cluster.

Install and tune your cluster following Search setup for OpenSearch 1.x and Elasticsearch 7.x–8.x where the workflow matches (OpenSearch 2.x instead of OpenSearch 1.x). Then use the same configuration workflow as on Search setup, starting with Configuring Nuxeo to Access the Search Cluster and the following sections (reindex, mappings, multi-repository, troubleshooting). In every nuxeo.conf property name, replace the opensearch1 segment with the client key for your search stack (see the example below).

For instance, you will have to use:

nuxeo.opensearch2.client.server=http://somenode:9200,https://anothernode:443
nuxeo.opensearch2.client.username=your_username
...
nuxeo.search.client.default.opensearch2.index.name=nuxeo
...

See also