Free and Open, Distributed, RESTful Search Engine
Find a file
Rory Hunter a7fdb08046
Fix docs for passing JVM args to ./gradlew run (#81253)
The instructions in `TESTING.asciidoc` for how to disable assertions
when running `./gradlew run` didn't work. Fix the docs by describing
how to pass JVM args, using disabling assertions as an example.
2021-12-03 09:16:23 +00:00
.ci Increase docker compose timeouts for CI builds 2021-11-23 12:53:28 -08:00
.github Add GitHub action for synchronizing commits from master to main branch 2021-08-24 15:51:33 -07:00
.idea Allow for debugging of rest test clusters during test execution (#79085) 2021-10-14 12:48:45 -07:00
benchmarks add benchmark to test xcontent parser filter performance (#80069) 2021-11-03 13:04:39 -04:00
build-conventions Checkstyle shadows vars pt8 (#81147) 2021-12-02 04:57:29 -05:00
build-tools Support additional version schemes in relaxed mode (#81010) 2021-11-24 13:02:00 -08:00
build-tools-internal Update gradle version to bugfix version 7.3.1 (#81243) 2021-12-03 08:54:58 +01:00
ccr/images [DOCS] Update remote cluster docs (#77043) 2021-09-22 16:02:33 -04:00
client Add replicated field to get data stream api response. (#80988) 2021-11-30 09:30:05 +01:00
dev-tools Improve atomic push script to support worktrees (#68873) 2021-02-11 10:13:15 -08:00
distribution Check downloaded beats archives (#81222) 2021-12-01 20:27:39 +00:00
docs Add date fields to the scripting fields api (#81272) 2021-12-02 14:37:48 -08:00
gradle/wrapper Update gradle version to bugfix version 7.3.1 (#81243) 2021-12-03 08:54:58 +01:00
libs Delegate Ref Counting to ByteBuf in Netty Transport (#81096) 2021-11-29 19:49:00 +01:00
licenses Keep low level rest client under Apache 2 software license (#68694) 2021-02-08 11:13:31 -08:00
modules Add date fields to the scripting fields api (#81272) 2021-12-02 14:37:48 -08:00
plugins Fail tests on unknown actions (#81230) 2021-12-02 16:57:40 +00:00
qa Add recovery infrastructure hook to work with older Lucene indices (#81056) 2021-12-02 16:01:45 +01:00
rest-api-spec Fix typo in field_caps API (#81280) 2021-12-03 10:30:06 +02:00
server Fix typo in field_caps API (#81280) 2021-12-03 10:30:06 +02:00
test Fail tests on unknown actions (#81230) 2021-12-02 16:57:40 +00:00
x-pack SQL: Fix rearranging columns in PIVOT queries (#81032) 2021-12-03 08:35:22 +01:00
.backportrc.json Update backport configuration to support prerelease version qualifiers 2021-10-27 10:34:39 -07:00
.dir-locals.el Go back to 140 column limit in .dir-locals.el 2017-04-14 08:50:53 -06:00
.editorconfig Fix compiler warnings in :server - part 3 (#76024) 2021-08-10 15:05:55 +01: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 [ML] Expected snapshot min version can now be 8 (#81054) 2021-11-25 19:48:12 +00: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 Update required JAVA_HOME variables for running tests (#80145) 2021-11-04 10:42:43 +01: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 docs for passing JVM args to ./gradlew run (#81253) 2021-12-03 09:16:23 +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.