Free and Open, Distributed, RESTful Search Engine
Find a file
2022-02-07 16:08:57 -08:00
.ci Remove CentOS from the CI matrix (#83512) 2022-02-04 14:14:53 +00:00
.github Update test-failure Issue Template to include "needs:triage" label #83226 2022-01-27 18:42:12 -05:00
.idea Upgrade Checkstyle to 9.3 (#83314) 2022-02-07 10:34:43 +00:00
benchmarks Make RoutingNodes behave like a collection (#83540) 2022-02-07 09:24:08 +01:00
build-conventions Upgrade Checkstyle to 9.3 (#83314) 2022-02-07 10:34:43 +00:00
build-tools Fix getBuildPluginFile for examples and thirdparty build (#82730) 2022-01-19 17:20:12 +01:00
build-tools-internal [DOCS] Remove major release references from migration guide (#83555) 2022-02-07 12:26:24 -05:00
ccr/images [DOCS] Update remote cluster docs (#77043) 2021-09-22 16:02:33 -04:00
client Remove MigrationClient from High Level Rest Client (#83609) 2022-02-07 17:06:51 -05:00
dev-tools Improve atomic push script to support worktrees (#68873) 2021-02-11 10:13:15 -08:00
distribution Upgrade jANSI dependency to 2.4.0 (#83566) 2022-02-07 11:44:37 +02:00
docs [DOCS] Clarify transform requirements (#83295) 2022-02-07 16:08:57 -08:00
gradle/wrapper Update gradle wrapper to 7.3.3 (#82057) 2021-12-23 06:57:43 -05:00
libs fix GeoToH3Tests#testRandomPoints (#83309) 2022-02-02 07:44:56 +01:00
licenses Keep low level rest client under Apache 2 software license (#68694) 2021-02-08 11:13:31 -08:00
modules Add getMinimalSupportedVersion to QueryBuilders (#83208) 2022-02-03 11:22:07 +01:00
plugins Expose Japanese completion filter to kuromoji analysis plugin (#81858) 2022-01-31 12:11:11 +00:00
qa Fixing random_sampler tests (#83549) 2022-02-07 08:34:37 -05:00
rest-api-spec TSDB: Fix time series bounds default value error (#83236) 2022-02-07 11:54:02 -10:00
server TSDB: Fix time series bounds default value error (#83236) 2022-02-07 11:54:02 -10:00
test Remove IndexLifecycleClient from High Level Rest Client (#83476) 2022-02-04 21:46:35 -07:00
x-pack [DOCS] Clarify transform requirements (#83295) 2022-02-07 16:08:57 -08:00
.backportrc.json Bump version to 8.2 2022-02-02 12:40:50 -08: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:18:34 +00:00
.git-blame-ignore-revs Fix typo in instructions for ignore-revs (#80058) 2021-11-04 12:10:55 +11:00
.gitattributes Assert no carriage returns in release notes test samples (#77238) 2021-09-07 20:45:23 +01:00
.gitignore Move custom checkstyle rule implementations to build-conventions project (#74017) 2021-06-10 16:06:44 -07:00
build.gradle Update version after backporting #83262 (#83355) 2022-02-01 12:53:28 +01:00
BUILDING.md Document how to test a dev version of a 3party dependency (#78962) 2021-10-13 05:23:37 -04:00
CONTRIBUTING.md Add guidance on logging to CONTRIBUTING.md (#75544) 2022-01-18 12:48:34 -05:00
gradle.properties Fix Spotless failing with InvocationTargetException on JDK 16 (#73246) 2021-05-20 08:46:20 +02:00
gradlew Update Gradle wrapper to 7.2 (#75894) 2021-08-18 05:11:28 -04:00
gradlew.bat Update gradle wrapper to 6.6 (#59909) 2020-08-11 10:17:33 +02:00
LICENSE.txt Update sources with new SSPL+Elastic-2.0 license headers 2021-02-02 16:10:53 -08:00
NOTICE.txt Remove Joda dependency (#79007) 2021-10-13 17:37:31 -07:00
README.asciidoc [DOCS] Refactor quick start guide and README (#71331) 2021-04-20 09:32:21 -04:00
settings.gradle Check whether stdout is a real console (#79882) 2021-10-28 14:06:33 +11:00
TESTING.asciidoc Fix typo in TESTING.asciidoc (#83120) 2022-01-26 17:01:19 +00:00
Vagrantfile Introduce ES_JAVA_HOME (#68954) 2021-02-17 12:41:23 -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.