--- title: Elasticsearch documentation hub description: Elasticsearch documentation. Index, search, and analyze data at any scale. Run it as a managed service or in your own environment. url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/9070/products/elasticsearch products: - Elastic Documentation - Elasticsearch --- # Elasticsearch documentation hub The distributed search and analytics engine at the heart of the Elastic platform. Index, search, and analyze data at any scale, build semantic and vector search experiences, and power applications. Run it as a managed service or in your own environment. ## Get started with Elasticsearch 1. Run Elasticsearch - Try for free on Elastic Cloud: Get an Elastic Stack running in a few minutes with no setup needed. [Start a free trial](https://cloud.elastic.co/registration) - Run locally: Spin up Elasticsearch on your machine for development with `start-local`. `curl -fsSL https://elastic.co/start-local | sh` 2. [Ingest your data into Elasticsearch](https://docs-v3-preview.elastic.dev/manage-data/ingest) Send documents to Elasticsearch using the APIs, ingest pipelines, connectors, or a language client. 3. [Search your data](https://docs-v3-preview.elastic.dev/solutions/search/querying-for-search) Build queries to find, rank, and analyze your documents. ## What's new in Elasticsearch Highlights from recent releases. - [9.5.5](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/release-notes) - [Serverless](https://docs-v3-preview.elastic.dev/release-notes/elastic-cloud-serverless) - [Vector database project type](https://docs-v3-preview.elastic.dev/solutions/vector-database) (Vector search) Run vector workloads on a Serverless project with vector-tuned defaults, inference access, and pricing built for embeddings. - [Cross-project search](https://docs-v3-preview.elastic.dev/explore-analyze/cross-project-search) (Search) Query data across several Serverless projects without moving or copying it, from Discover, ES|QL, dashboards, and alerting. Generally available. - [ES|QL HIGHLIGHT command](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/esql/commands/highlight) (ES|QL) Show which terms matched a full-text query by wrapping them in highlight tags in your ES|QL results. Generally available. - [Columnar index mode](https://docs-v3-preview.elastic.dev/manage-data/data-store/columnar) (Storage) Store each field once in a column store, with no inverted index by default, for a smaller footprint. Technical preview. - [Native Prometheus and PromQL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/promql) (Metrics) Query Prometheus metrics with PromQL in Elasticsearch, generally available. - [Upgrade Elasticsearch](https://docs-v3-preview.elastic.dev/deploy-manage/upgrade/deployment-or-cluster) ### Elastic solutions Solutions are packages of Elastic capabilities optimized for certain use cases. All solutions include the core storage, querying, and analytics capabilities of Elasticsearch and Kibana. #### Elasticsearch - [Overview](https://docs-v3-preview.elastic.dev/solutions/elasticsearch-solution-project) - [Get started](https://docs-v3-preview.elastic.dev/solutions/elasticsearch-solution-project/get-started) - [Agent Builder](https://docs-v3-preview.elastic.dev/explore-analyze/ai-features/elastic-agent-builder) - [Query rules](https://docs-v3-preview.elastic.dev/solutions/elasticsearch-solution-project/query-rules-ui) - [Content connectors](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/search-connectors) - [Index management](https://docs-v3-preview.elastic.dev/manage-data/data-store/perform-index-operations) #### Vector Database - [Overview](https://docs-v3-preview.elastic.dev/solutions/vector-database) - [Get started](https://docs-v3-preview.elastic.dev/solutions/vector-database/get-started) - [Vector and full-text search](https://docs-v3-preview.elastic.dev/solutions/vector-database/vector-full-text-search) - [RAG](https://docs-v3-preview.elastic.dev/solutions/search/rag) - [Hybrid search](https://docs-v3-preview.elastic.dev/solutions/search/hybrid-search) - [Semantic search](https://docs-v3-preview.elastic.dev/solutions/search/semantic-search) #### Observability - [Overview](https://docs-v3-preview.elastic.dev/solutions/observability) - [Get started](https://docs-v3-preview.elastic.dev/solutions/observability/get-started) - [APM](https://docs-v3-preview.elastic.dev/solutions/observability/apm) - [Logs](https://docs-v3-preview.elastic.dev/solutions/observability/logs) - [Infrastructure](https://docs-v3-preview.elastic.dev/solutions/observability/infra-and-hosts) - [Synthetics](https://docs-v3-preview.elastic.dev/solutions/observability/synthetics) #### Security - [Overview](https://docs-v3-preview.elastic.dev/solutions/security) - [Get started](https://docs-v3-preview.elastic.dev/solutions/security/get-started) - [SIEM](https://docs-v3-preview.elastic.dev/solutions/security/get-started/get-started-detect-with-siem) - [Detection rules](https://docs-v3-preview.elastic.dev/solutions/security/detect-and-alert/manage-detection-rules) - [Elastic Defend](https://docs-v3-preview.elastic.dev/solutions/security/configure-elastic-defend) - [Cases](https://docs-v3-preview.elastic.dev/solutions/security/investigate/security-cases) ### Get hands-on with Elasticsearch New to Elasticsearch? Follow a guided quickstart to index and search your first data set. #### Search fundamentals - [Index and search basics](https://docs-v3-preview.elastic.dev/solutions/search/get-started/index-basics) - [Build your first query with Python](https://docs-v3-preview.elastic.dev/solutions/search/get-started/keyword-search-python) #### Semantic search and ES|QL - [Get started with semantic search](https://docs-v3-preview.elastic.dev/solutions/search/get-started/semantic-search) - [ES|QL tutorials](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/esql/esql-examples) #### Specialized quickstarts - [Time series data stream basics](https://docs-v3-preview.elastic.dev/manage-data/data-store/data-streams/quickstart-tsds) - [Browse all quickstarts](https://docs-v3-preview.elastic.dev/solutions/search/get-started/quickstarts) ## Explore Elasticsearch Find the Elasticsearch documentation you need, organized by task, from deploying and ingesting to searching, securing, and operating. ### Quick links #### Releases and APIs - [Release notes](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/release-notes) - [Elasticsearch API docs](https://www.elastic.co/docs/api/doc/elasticsearch) - [Language clients](https://docs-v3-preview.elastic.dev/reference/elasticsearch-clients) #### Configuration - [Configure Elastic Stack settings](https://docs-v3-preview.elastic.dev/deploy-manage/stack-settings) - [Cluster configuration reference](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/configuration-reference) - [Index settings](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/index-settings) #### Operations - [Production guidance](https://docs-v3-preview.elastic.dev/deploy-manage/production-guidance/elasticsearch-in-production-environments) - [Upgrade Elasticsearch](https://docs-v3-preview.elastic.dev/deploy-manage/upgrade/deployment-or-cluster) - [Technical reference](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch) #### Search and query - [ES|QL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/esql/esql-getting-started) - [Search API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search) - [Query DSL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/query-dsl/full-text-queries) ### Deploy and manage #### Use Elastic Cloud - [Serverless](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/elastic-cloud/serverless) - [Elastic Cloud Hosted](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/elastic-cloud/cloud-hosted) #### Deploy with an orchestrator - [Elastic Cloud on Kubernetes (ECK)](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/cloud-on-k8s) - [Elastic Cloud Enterprise (ECE)](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/cloud-enterprise) #### [Run Elasticsearch yourself](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/installing-elasticsearch) - [Docker](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/install-elasticsearch-with-docker) - [Debian / Ubuntu](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/install-elasticsearch-with-debian-package) - [RHEL / CentOS](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/install-elasticsearch-with-rpm) - [Linux / macOS archive](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/install-elasticsearch-from-archive-on-linux-macos) - [Windows](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/install-elasticsearch-with-zip-on-windows) - [Configure Elasticsearch](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/configure-elasticsearch) #### Design your deployment - [Distributed architecture](https://docs-v3-preview.elastic.dev/deploy-manage/distributed-architecture) - [Production guidance](https://docs-v3-preview.elastic.dev/deploy-manage/production-guidance/elasticsearch-in-production-environments) - [Reference architectures](https://docs-v3-preview.elastic.dev/deploy-manage/reference-architectures) #### Operate and maintain - [Monitor Elasticsearch](https://docs-v3-preview.elastic.dev/deploy-manage/monitor) - [Autoscaling](https://docs-v3-preview.elastic.dev/deploy-manage/autoscaling) - [Maintenance and restarts](https://docs-v3-preview.elastic.dev/deploy-manage/maintenance) - [Upgrade Elasticsearch](https://docs-v3-preview.elastic.dev/deploy-manage/upgrade/deployment-or-cluster) - [Migrate data](https://docs-v3-preview.elastic.dev/manage-data/migrate) ### Prepare and index data #### Index data - [Index API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index) - [Bulk API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-bulk) - [Indices and data streams](https://docs-v3-preview.elastic.dev/manage-data/data-store) - [Tune for indexing speed](https://docs-v3-preview.elastic.dev/deploy-manage/production-guidance/optimize-performance/indexing-speed) #### Transform and enrich - [Ingest pipelines](https://docs-v3-preview.elastic.dev/manage-data/ingest/transform-enrich/ingest-pipelines) - [Transforms](https://docs-v3-preview.elastic.dev/explore-analyze/transforms) - [Enrich data](https://docs-v3-preview.elastic.dev/manage-data/ingest/transform-enrich/data-enrichment) - [Ingest processors](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/ingest-processor) #### Map fields - [Mappings](https://docs-v3-preview.elastic.dev/manage-data/data-store/mapping) - [Field types](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/mapping-reference/field-data-types) - [Runtime fields](https://docs-v3-preview.elastic.dev/manage-data/data-store/mapping/runtime-fields) #### Analyze text - [Text analysis](https://docs-v3-preview.elastic.dev/manage-data/data-store/text-analysis) - [Configure analyzers](https://docs-v3-preview.elastic.dev/manage-data/data-store/text-analysis/configure-text-analysis) #### [Ingestion tools](https://docs-v3-preview.elastic.dev/manage-data/ingest) - [Choose an ingest method](https://docs-v3-preview.elastic.dev/manage-data/ingest) - [Fleet and Elastic Agent](https://docs-v3-preview.elastic.dev/reference/fleet) - [Logstash](https://docs-v3-preview.elastic.dev/elastic/logstash/tree/main/reference) - [Beats](https://docs-v3-preview.elastic.dev/elastic/beats/tree/main/reference) - [Elastic Distributions of OpenTelemetry](https://docs-v3-preview.elastic.dev/elastic/opentelemetry/tree/main/reference) - [Connectors](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/search-connectors) ### Search and analyze data #### Search with the Search API - [Search API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search) - [Query DSL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/query-dsl/full-text-queries) - [Retrievers](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/rest-apis/retrievers) #### ES|QL - [Get started with ES|QL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/esql/esql-getting-started) - [Syntax reference](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/esql/esql-syntax-reference) - [ES|QL for search](https://docs-v3-preview.elastic.dev/solutions/search/esql-for-search) #### Choose a search approach - [Search approaches overview](https://docs-v3-preview.elastic.dev/solutions/search/search-approaches) - [Full-text search](https://docs-v3-preview.elastic.dev/solutions/search/full-text) - [Geospatial search](https://docs-v3-preview.elastic.dev/explore-analyze/geospatial-analysis) #### Machine learning and inference - [Machine learning](https://docs-v3-preview.elastic.dev/explore-analyze/machine-learning) - [Elastic Inference](https://docs-v3-preview.elastic.dev/explore-analyze/elastic-inference) #### Search across clusters and projects - [Cross-cluster search](https://docs-v3-preview.elastic.dev/explore-analyze/cross-cluster-search) - [Cross-project search](https://docs-v3-preview.elastic.dev/explore-analyze/cross-project-search) #### Improve search results - [Search relevance](https://docs-v3-preview.elastic.dev/solutions/search/full-text/search-relevance) - [Ranking and reranking](https://docs-v3-preview.elastic.dev/solutions/search/ranking) - [Synonyms](https://docs-v3-preview.elastic.dev/solutions/search/full-text/search-with-synonyms) - [Tune for search speed](https://docs-v3-preview.elastic.dev/deploy-manage/production-guidance/optimize-performance/search-speed) ### Vector database #### Semantic and vector search - [Semantic search](https://docs-v3-preview.elastic.dev/solutions/search/semantic-search) - [Vector search](https://docs-v3-preview.elastic.dev/solutions/search/vector) - [Hybrid search](https://docs-v3-preview.elastic.dev/solutions/search/hybrid-search) #### Inference - [Inference API](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) - [Semantic search with inference](https://docs-v3-preview.elastic.dev/solutions/search/semantic-search/semantic-search-inference) ### Build applications #### APIs, clients, and examples - [Elasticsearch API docs](https://www.elastic.co/docs/api/doc/elasticsearch) - [Serverless Elasticsearch API docs](https://www.elastic.co/docs/api/doc/elasticsearch-serverless) - [Language clients](https://docs-v3-preview.elastic.dev/reference/elasticsearch-clients) - [REST API examples](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/rest-apis/api-examples) #### Agent Builder - [Get started](https://docs-v3-preview.elastic.dev/explore-analyze/ai-features/elastic-agent-builder) - [Programmatic access](https://docs-v3-preview.elastic.dev/explore-analyze/ai-features/agent-builder/programmatic-access) - [MCP server](https://docs-v3-preview.elastic.dev/explore-analyze/ai-features/agent-builder/mcp-server) #### Search templates - [Search templates](https://docs-v3-preview.elastic.dev/solutions/search/search-templates) #### Painless scripting - [Write Painless scripts](https://docs-v3-preview.elastic.dev/explore-analyze/scripting/modules-scripting-painless) - [Language specification](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/scripting-languages/painless/painless-language-specification) ### Manage the data lifecycle #### Choose a strategy - [Data lifecycle overview](https://docs-v3-preview.elastic.dev/manage-data/lifecycle) #### Data stream lifecycle - [Data stream lifecycle](https://docs-v3-preview.elastic.dev/manage-data/lifecycle/data-stream) - [Downsampling](https://docs-v3-preview.elastic.dev/manage-data/data-store/data-streams/downsampling-time-series-data-stream) #### Index lifecycle management - [Index lifecycle management (ILM)](https://docs-v3-preview.elastic.dev/manage-data/lifecycle/index-lifecycle-management) - [Data tiers](https://docs-v3-preview.elastic.dev/manage-data/lifecycle/data-tiers) #### Protect and recover data - [Snapshot and restore](https://docs-v3-preview.elastic.dev/deploy-manage/tools/snapshot-and-restore) - [Cross-cluster replication](https://docs-v3-preview.elastic.dev/deploy-manage/tools/cross-cluster-replication) - [Searchable snapshots](https://docs-v3-preview.elastic.dev/deploy-manage/tools/snapshot-and-restore/searchable-snapshots) ### Secure Elasticsearch #### Get started with security - [Security overview](https://docs-v3-preview.elastic.dev/deploy-manage/security) #### Protect data and connections - [Initial security setup](https://docs-v3-preview.elastic.dev/deploy-manage/security/secure-your-cluster-deployment) - [TLS encryption](https://docs-v3-preview.elastic.dev/deploy-manage/security/secure-cluster-communications) - [Network security](https://docs-v3-preview.elastic.dev/deploy-manage/security/network-security) #### [Authenticate users](https://docs-v3-preview.elastic.dev/deploy-manage/users-roles) - [Cluster-level authentication](https://docs-v3-preview.elastic.dev/deploy-manage/users-roles/cluster-or-deployment-auth/user-authentication) - [Cloud organization SSO](https://docs-v3-preview.elastic.dev/deploy-manage/users-roles/cloud-organization/configure-saml-authentication) #### Control access - [User roles](https://docs-v3-preview.elastic.dev/deploy-manage/users-roles/cluster-or-deployment-auth/defining-roles) - [Serverless custom roles](https://docs-v3-preview.elastic.dev/deploy-manage/users-roles/serverless-custom-roles) - [API keys](https://docs-v3-preview.elastic.dev/deploy-manage/api-keys) - [Field and document-level security](https://docs-v3-preview.elastic.dev/deploy-manage/users-roles/cluster-or-deployment-auth/controlling-access-at-document-field-level) - [Audit logging](https://docs-v3-preview.elastic.dev/deploy-manage/monitor/stack-audit-logging) ### Troubleshoot #### Cluster health and availability - [Cluster issues](https://docs-v3-preview.elastic.dev/troubleshoot/elasticsearch/clusters) - [Capture diagnostics](https://docs-v3-preview.elastic.dev/troubleshoot/elasticsearch/diagnostic) #### Indexing and search - [Troubleshoot search](https://docs-v3-preview.elastic.dev/troubleshoot/elasticsearch/troubleshooting-searches) #### Snapshot and restore - [Snapshot problems](https://docs-v3-preview.elastic.dev/troubleshoot/elasticsearch/snapshot-and-restore) #### Clients - [Client problems](https://docs-v3-preview.elastic.dev/troubleshoot/elasticsearch/clients) ### Reference #### Elasticsearch reference - [Cluster configuration](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/configuration-reference) - [Index settings](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/index-settings) - [Mapping](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/mapping-reference) - [Aggregations](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/aggregations) - [Text analysis](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/text-analysis) - [Ingest processors](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/ingest-processor) #### APIs and query languages - [REST APIs and conventions](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/rest-apis) - [Query DSL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/query-dsl/full-text-queries) - [ES|QL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/esql/esql-getting-started) - [Elasticsearch SQL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/sql) - [EQL](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/query-languages/eql) #### Clients and tools - [Language clients](https://docs-v3-preview.elastic.dev/reference/elasticsearch-clients) - [Elastic CLI](https://docs-v3-preview.elastic.dev/elastic/cli/tree/main/) - [Command-line tools](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/command-line-tools) - [Plugins](https://docs-v3-preview.elastic.dev/deploy-manage/deploy/self-managed/plugins)