8.2 series - Hibernate Search

Compatibility

Java	17, 21, or 25
Hibernate ORM	7.2
Elasticsearch server	7.10 - 9.2
OpenSearch server	1.3 - 3.4
Apache Lucene	9.12 / 10.3

Not compatible with your requirements? Have a look at the other series.

See also the Compatibility policy and Maintenance policy.

Documentation

Documentation for Hibernate Search 8.2 can be accessed through the links below:

Getting started guide (ORM) HTML PDF

Getting started guide (Standalone) HTML PDF

What's new HTML PDF

Migration guide HTML PDF

Reference HTML PDF API (Javadoc)

You can find more documentation for all series on the documentation page.

How to get it

Current series status: latest stable

Maven artifacts of Hibernate Search are published to Maven Central. Most build tools fetch artifacts from Maven Central by default, but if that's not the case for you, see this page to configure your build tool.

You can find the Maven coordinates of all artifacts through the link below:

Maven artifacts

Below are the Maven coordinates of the main artifacts.

Hibernate Search BOM

Hibernate Search Platform BOM

Hibernate Search Platform (for the lucene-next backend) BOM

Hibernate ORM mapper

"outbox-polling" coordination strategy for the Hibernate ORM mapper

Standalone POJO mapper

Lucene backend backed by Lucene 9.12

Lucene backend backed by Lucene 10

Elasticsearch/OpenSearch backend

Amazon IAM authentication for Elasticsearch/OpenSearch

Elasticsearch/OpenSearch backend REST client based on elasticsearch-rest-client and Apache HTTP Client 4

Elasticsearch/OpenSearch backend REST client based on elasticsearch-rest5-client and Apache HTTP Client 5

Elasticsearch/OpenSearch backend REST client based on opensearch-rest-client and Apache HTTP Client 5

Jakarta Batch mass indexing job for the Hibernate ORM mapper - Core

Jakarta Batch mass indexing job for the Hibernate ORM mapper - JBeret specifics

Helper for migrating from Hibernate Search 5 to Hibernate Search 6/7/8 (Hibernate ORM mapper + Lucene backend)

Hibernate Search annotation processor capable of generating the static metamodel

All Maven artifacts of this project released after 2022-01-26 are signed.

To verify signed Maven artifacts, head to this page.

Direct download

Individual Maven artifacts may be downloaded directly from the Maven repository:

Maven Central subdirectory

See here for how to download all dependencies of your Maven project to a local directory on your filesystem.

See here for how to download an explicitly listed set of artifacts to a local directory on your filesystem.

More information about specific releases (announcements, download links) can be found here.

What's new

Latest release announcement (2026-02-18): 8.2.2.Final.

Highlights of new features and enhancements can be found here:

HTML PDF

A detailed list of new features, improvements and fixes in this series can be found on our issue tracker.

Development versions (SNAPSHOTS)

The latest development versions of Maven artifacts for Hibernate Search are published to the Sonatype Maven Central snapshots repository.

Sonatype Maven Central snapshots subdirectory

You should only need those (unstable) versions for testing recently merged patches, and should never use them in production.

To consume these artifacts, you may need to configure your build tool to fetch artifacts from https://central.sonatype.com/repository/maven-snapshots and to enable snapshots:

Maven Gradle