Free and Open, Distributed, RESTful Search Engine
Find a file
2024-04-05 19:15:40 +02:00
.buildkite Remove redundant testing of Java 22 (#106943) 2024-04-01 08:30:52 -07:00
.ci Reduce BWC testing to include only latest patch releases (#106143) 2024-03-27 15:37:36 -07:00
.github Add version command to issue template 2017-07-31 08:55:31 +09:00
.idea Ensure RUNTIME_JAVA_HOME is used for pre-7.0 package upgrade tests (#91629) 2022-11-16 14:56:38 -08:00
benchmarks [7.17] Update Gradle Wrapper to 8.2 (#96686) (#97484) 2023-09-27 08:46:44 +02:00
build-conventions [7.17] Allow resolving runtime java via Gradle tool chain provider (#105916) 2024-03-05 11:17:44 +01:00
build-tools Remove invalid javadoc reference (#106139) 2024-03-08 15:07:29 -05:00
build-tools-internal [7.17.20] Downgrade the bundled JDK to JDK 21.0.2 (#107142) 2024-04-05 15:31:43 +01:00
ccr/images [DOCS] Update remote cluster docs (#77043) (#78212) 2021-09-23 12:13:03 +02:00
client [7.17] Manual backport of 103944 (#104016) 2024-01-08 11:31:01 -05:00
dev-tools Update sources with new SSPL+Elastic-2.0 license headers 2021-02-02 18:07:23 -08:00
distribution Upgrade Bouncy Castle FIPS jars for plugin cli (#103801) 2024-01-05 08:28:21 -06:00
docs Update 7.17.19 known issues with JDK 22 bug / recommendation to downgrade (#107165) 2024-04-05 19:15:40 +02:00
gradle [7.17.20] Downgrade the bundled JDK to JDK 21.0.2 (#107142) 2024-04-05 15:31:43 +01:00
libs Adjust terminal tests to new behavior in JDK 22. (#103614) (#106051) 2024-03-06 19:29:27 -05:00
licenses [7.x] Keep low level rest client under Apache 2 software license (#68697) 2021-02-08 11:14:18 -08:00
modules Limiting the number of nested pipelines that can be executed (#105428) (#105533) 2024-02-15 07:50:27 -06:00
plugins Update Gradle wrapper to 8.7 (#105854) (#106722) 2024-03-26 08:33:29 +01:00
qa Upgrade Bouncy Castle FIPS jars for plugin cli (#103801) 2024-01-05 08:28:21 -06:00
rest-api-spec [7.17] Revert YAML tests changes related to index sorting (#93753) (#93781) 2023-02-14 08:14:28 -05:00
server Bump versions after 7.17.19 release 2024-03-26 20:00:24 +00:00
test Fix random timezone id selection to be consistent with DateUtilsTests.testTimezoneIds (#105989) 2024-03-06 07:35:15 +01:00
x-pack Mute SamlAuthenticationIT on 7.17 branch (#106993) 2024-04-02 14:51:40 +02:00
.dir-locals.el Go back to 140 column limit in .dir-locals.el 2017-04-14 08:50:53 -06:00
.editorconfig Formatting escape hatch (#81806) 2021-12-16 16:28:17 +00:00
.git-blame-ignore-revs Add bulk reformat commit hash to git blame ignore file 2021-10-27 15:23:53 -07:00
.gitattributes Assert no carriage returns in release notes test samples (#77238) 2021-09-07 20:47:15 +01:00
.gitignore Configure required IDEA plugins (#84674) 2022-03-07 17:02:48 +00:00
build.gradle Update verifyVersion task after #106143 2024-03-27 15:37:40 -07:00
BUILDING.md [7.17] Add verification metadata for dependencies (#88814) (#89105) 2022-08-08 12:30:59 +02:00
catalog-info.yaml [7.17] [buildkite] Add most of the remaining periodic pipelines (#98043) (#99262) 2023-09-06 15:28:14 -04:00
CONTRIBUTING.md [7.17] Bump minimum compiler version to Java 17 (#85935) 2022-04-18 10:11:37 -07:00
elasticsearch Bump version to v7.14.0 2021-04-21 12:36:56 +01:00
gradle.properties Suppress gradle welcome messages (#102898) (#102911) 2023-12-04 12:08:32 +01:00
gradlew [7.17] Update gradle wrapper to 8.4 (#99856) (#100926) 2023-10-17 13:44:48 +02:00
gradlew.bat Update Gradle wrapper to 8.6 (#103796) (#105466) 2024-02-13 15:14:48 -05:00
LICENSE.txt Update sources with new SSPL+Elastic-2.0 license headers 2021-02-02 18:07:23 -08:00
NOTICE.txt Update sources with new SSPL+Elastic-2.0 license headers 2021-02-02 18:07:23 -08:00
README.asciidoc [DOCS] Refactor quick start guide and README (#71331) (#71936) 2021-04-20 10:26:15 -04:00
rewrite.yml Auto backport java util Map / Set / List of methods (#76038) 2021-09-21 17:15:45 +02:00
settings.gradle [7.17] Allow resolving runtime java via Gradle tool chain provider (#105916) 2024-03-05 11:17:44 +01:00
TESTING.asciidoc Add mechanism to initialize YAML tests against a subset of test cases (#95095) (#95097) 2023-04-06 21:35:25 -04:00
Vagrantfile Introduce ES_JAVA_HOME (#68954) 2021-02-17 12:44:34 -05:00

= Elasticsearch

Elasticsearch is the distributed, RESTful search and analytics engine at the
heart of the https://www.elastic.co/products[Elastic Stack]. You can use
Elasticsearch to store, search, and manage data for:

* Logs
* Metrics
* A search backend
* Application monitoring
* Endpoint security

\... and more!

To learn more about Elasticsearch's features and capabilities, see our
https://www.elastic.co/products/elasticsearch[product page].

[[get-started]]
== Get started

The simplest way to set up Elasticsearch is to create a managed deployment with
https://www.elastic.co/cloud/as-a-service[Elasticsearch Service on Elastic
Cloud].

If you prefer to install and manage Elasticsearch yourself, you can download
the latest version from 
https://www.elastic.co/downloads/elasticsearch[elastic.co/downloads/elasticsearch].

For more installation options, see the
https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html[Elasticsearch installation
documentation].

[[upgrade]]
== Upgrade

To upgrade from an earlier version of Elasticsearch, see the
https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html[Elasticsearch upgrade
documentation].

[[build-source]]
== Build from source

Elasticsearch uses https://gradle.org[Gradle] for its build system.

To build a distribution for your local OS and print its output location upon
completion, run:
----
./gradlew localDistro
----

To build a distribution for another platform, run the related command:
----
./gradlew :distribution:archives:linux-tar:assemble
./gradlew :distribution:archives:darwin-tar:assemble
./gradlew :distribution:archives:windows-zip:assemble
----

To build distributions for all supported platforms, run:
----
./gradlew assemble
----

Distributions are output to `distributions/archives`.

To run the test suite, see xref:TESTING.asciidoc[TESTING].

[[docs]]
== Documentation

For the complete Elasticsearch documentation visit
https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html[elastic.co].

For information about our documentation processes, see the
xref:docs/README.asciidoc[docs README].

[[contribute]]
== Contribute

For contribution guidelines, see xref:CONTRIBUTING.md[CONTRIBUTING]. 

[[questions]]
== Questions? Problems? Suggestions?

* To report a bug or request a feature, create a
https://github.com/elastic/elasticsearch/issues/new/choose[GitHub Issue]. Please
ensure someone else hasn't created an issue for the same topic.

* Need help using Elasticsearch? Reach out on the
https://discuss.elastic.co[Elastic Forum] or https://ela.st/slack[Slack]. A
fellow community member or Elastic engineer will be happy to help you out.