Solr System Requirements

This Wiki page reproduces the information in the Solr 8.0 Reference Guide which is in the process of being released (5-Apr, 2019). Once the reference guide is released, this page will be deprecated. You should check the above link for the most recent information.

You can install Solr in any system where a suitable Java Runtime Environment (JRE) is available.

Installation Requirements

Supported Operating Systems

Solr is tested on several versions of Linux, macOS and Windows.

Java Requirements

You will need the Java Runtime Environment (JRE) version 1.8 or higher. At a command line, check your Java version like this:

$ java -version
java version "1.8.0_60"
Java(TM) SE Runtime Environment (build 1.8.0_60-b27)
Java HotSpot(TM) 64-Bit Server VM (build 25.60-b23, mixed mode)

The exact output will vary, but you need to make sure you meet the minimum version requirement. We also recommend choosing a version that is not end-of-life from its vendor. Oracle/OpenJDK are the most tested JREs and are preferred. It's also preferred to use the latest available official release.

Some versions of Java VM have bugs that may impact your implementation. To be sure, check the page Lucene Java Bugs.

Sources for Java

Java is available from a number of providers. Lucene and Solr regularly test with OpenJDK/Oracle versions of Java. Some are free, others have a cost, some provide security patches and support, others do not. We recommend you read the article Java is still free by Java Champions to help you decide.

The Lucene project does not endorse any particular provider of Java.

While we reference the Java Development (JDK) on this page, any Java Runtime Environment (JRE) associated with the referenced JDKs is acceptable.

Java and Lucene/Solr combinations

Each Lucene/Solr release has an extensively tested minimum Java version. For instance the minimum Java version for Solr 8 is Java 8. This section is intended to provide guidance when running Lucene/Solr with a more recent Java version than the minimum specified.

Executive summary

The rest of this page summarizes the Lucene/Solr community's testing experience for Lucene/Solr releases.

How we test Solr/Lucene

Solr and Lucene run a continuous integration model, running automated unit and integration tests using several versions of Java. In addition, some organizations also maintain their own test infrastructure and feed their results back to the community.

Our continuous testing is against the two code lines under active development, Solr 8x and the future Solr 9.0:

Released Lucene/Solr and Java Versions

The success rate in our automated tests is similar with all the Java versions tested with the following caveats.

Lucene/Solr prior to 7.0

Lucene/Solr 7

Lucene/Solr 8

SolrJavaVersions (last edited 2019-04-05 17:19:52 by ErickErickson)