1= Elasticsearch
2
3Elasticsearch is the distributed, RESTful search and analytics engine at the
4heart of the https://www.elastic.co/products[Elastic Stack]. You can use
5Elasticsearch to store, search, and manage data for:
6
7* Logs
8* Metrics
9* A search backend
10* Application monitoring
11* Endpoint security
12
13\... and more!
14
15To learn more about Elasticsearch's features and capabilities, see our
16https://www.elastic.co/products/elasticsearch[product page].
17
18[[get-started]]
19== Get started
20
21The simplest way to set up Elasticsearch is to create a managed deployment with
22https://www.elastic.co/cloud/as-a-service[Elasticsearch Service on Elastic
23Cloud].
24
25If you prefer to install and manage Elasticsearch yourself, you can download
26the latest version from
27https://www.elastic.co/downloads/elasticsearch[elastic.co/downloads/elasticsearch].
28
29For more installation options, see the
30https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html[Elasticsearch installation
31documentation].
32
33[[upgrade]]
34== Upgrade
35
36To upgrade from an earlier version of Elasticsearch, see the
37https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html[Elasticsearch upgrade
38documentation].
39
40[[build-source]]
41== Build from source
42
43Elasticsearch uses https://gradle.org[Gradle] for its build system.
44
45To build a distribution for your local OS and print its output location upon
46completion, run:
47----
48./gradlew localDistro
49----
50
51To build a distribution for another platform, run the related command:
52----
53./gradlew :distribution:archives:linux-tar:assemble
54./gradlew :distribution:archives:darwin-tar:assemble
55./gradlew :distribution:archives:windows-zip:assemble
56----
57
58To build distributions for all supported platforms, run:
59----
60./gradlew assemble
61----
62
63Distributions are output to `distributions/archives`.
64
65To run the test suite, see xref:TESTING.asciidoc[TESTING].
66
67[[docs]]
68== Documentation
69
70For the complete Elasticsearch documentation visit
71https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html[elastic.co].
72
73For information about our documentation processes, see the
74xref:docs/README.asciidoc[docs README].
75
76[[contribute]]
77== Contribute
78
79For contribution guidelines, see xref:CONTRIBUTING.md[CONTRIBUTING].
80
81[[questions]]
82== Questions? Problems? Suggestions?
83
84* To report a bug or request a feature, create a
85https://github.com/elastic/elasticsearch/issues/new/choose[GitHub Issue]. Please
86ensure someone else hasn't created an issue for the same topic.
87
88* Need help using Elasticsearch? Reach out on the
89https://discuss.elastic.co[Elastic Forum] or https://ela.st/slack[Slack]. A
90fellow community member or Elastic engineer will be happy to help you out.
91