opensearch-docs-cn/_opensearch/install/compatibility.md

---
layout: default
title: Compatibility
parent: Install OpenSearch
nav_order: 2
---

# Operating system and JVM compatibility

- We recommend installing OpenSearch on RHEL- or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, and Ubuntu (LTS). OpenSearch should work on many Linux distributions, but we only test a handful.
- The OpenSearch tarball ships with a compatible version of Java in the `jdk` directory. To find its version, run `./jdk/bin/java -version`. For example, the OpenSearch 1.0.0 tarball ships with Java 15 (non-LTS).

{% comment %}`./jdk/bin/java -version` doesn't work on macOS with zsh at the moment, and I have no idea why. Maybe we need a macOS artifact. Regardless, the command works on Amazon Linux 2 with bash and presumably other distros. - aetter{% endcomment %}

  To use a different Java installation, set the `JAVA_HOME` environment variable to the Java install location. We recommend Java 11 (LTS), but OpenSearch also works with Java 8.

OpenSearch version | Compatible Java versions | Recommended operating systems
:--- | :--- | :---
1.x | 8, 11, 15 | Red Hat Enterprise Linux 7, 8; CentOS 7, 8; Amazon Linux 2; Ubuntu 16.04, 18.04, 20.04

If you plan on running applications besides OpenSearch with different Java requirements, set the `OPENSEARCH_JAVA_HOME` environment variable to the location of the Java installation to be used by OpenSearch. `OPENSEARCH_JAVA_HOME` supersedes the `JAVA_HOME` environment variable.
Add Java and OS recommendations 2021-06-23 12:45:20 -04:00			`---`
			`layout: default`
			`title: Compatibility`
			`parent: Install OpenSearch`
			`nav_order: 2`
			`---`

			`# Operating system and JVM compatibility`

			`- We recommend installing OpenSearch on RHEL- or Debian-based Linux distributions that use [systemd](https://en.wikipedia.org/wiki/Systemd), such as CentOS, Amazon Linux 2, and Ubuntu (LTS). OpenSearch should work on many Linux distributions, but we only test a handful.`
Add example version, correct command 2021-07-08 13:47:51 -04:00			- The OpenSearch tarball ships with a compatible version of Java in the `jdk` directory. To find its version, run `./jdk/bin/java -version`. For example, the OpenSearch 1.0.0 tarball ships with Java 15 (non-LTS).

			{% comment %}`./jdk/bin/java -version` doesn't work on macOS with zsh at the moment, and I have no idea why. Maybe we need a macOS artifact. Regardless, the command works on Amazon Linux 2 with bash and presumably other distros. - aetter{% endcomment %}
Add Java and OS recommendations 2021-06-23 12:45:20 -04:00
Update Java home variable to be correct updates docs to us `JAVA_HOME` Signed-off-by: Eli Fisher <elifish@amazon.com> 2022-01-14 13:51:42 -05:00			To use a different Java installation, set the `JAVA_HOME` environment variable to the Java install location. We recommend Java 11 (LTS), but OpenSearch also works with Java 8.
Add Java and OS recommendations 2021-06-23 12:45:20 -04:00
			`OpenSearch version \| Compatible Java versions \| Recommended operating systems`
			`:--- \| :--- \| :---`
Added shrink index API and fixed Java compatibility Signed-off-by: keithhc2 <keithhc2@users.noreply.github.com> 2021-11-29 18:13:45 -05:00			`1.x \| 8, 11, 15 \| Red Hat Enterprise Linux 7, 8; CentOS 7, 8; Amazon Linux 2; Ubuntu 16.04, 18.04, 20.04`
[FEATURE] Document OPENSEARCH_JAVA_HOME Signed-off-by: Andriy Redko <andriy.redko@aiven.io> 2022-02-15 12:11:59 -05:00
Slight correction of 'the' article Signed-off-by: Andriy Redko <andriy.redko@aiven.io> 2022-02-15 15:23:09 -05:00			If you plan on running applications besides OpenSearch with different Java requirements, set the `OPENSEARCH_JAVA_HOME` environment variable to the location of the Java installation to be used by OpenSearch. `OPENSEARCH_JAVA_HOME` supersedes the `JAVA_HOME` environment variable.