search mobile facets autocomplete spellcheck crawler rankings weights synonyms analytics engage api customize documentation install setup technology content domains user history info home business cart chart contact email activate analyticsalt analytics autocomplete cart contact content crawling custom documentation domains email engage faceted history info install mobile person querybuilder search setup spellcheck synonyms weights engage_search_term engage_related_content engage_next_results engage_personalized_results engage_recent_results success add arrow-down arrow-left arrow-right arrow-up caret-down caret-left caret-right caret-up check close content conversions-small conversions details edit grid help small-info error live magento minus move photo pin plus preview refresh search settings small-home stat subtract text trash unpin wordpress x alert case_deflection advanced-permissions keyword-detection predictive-ai sso

Enterprise Search, Installation

Enterprise Search can be hosted within your own infrastructure.

The offering is currently in beta and can be downloaded free for experimentation.

We would love your feedback as you check things out:

Visit the troubleshooting page for diagnostic help and known issues.

Supported platforms:

  • Linux: x86_64 only
  • MacOS X: High Sierra 10.13 - 10.1x (64 bit only)
  • Windows: Not supported

Minimum hardware:

  • ~4GB of free RAM or 6GB if Elasticsearch is running on the same machine.
    • 2GB for App Server.
    • 2GB for Worker.
    • 50Mb for Filebeat and other processes.
  • 5GB of disk space available.



  • Elasticsearch must have a platinum license. A 30 day trial license can be activated during your first run of Enterprise Search.
  • When using security features within your Elasticsearch cluster, define a minimum Elasticsearch role:
  "cluster" : [ "manage_index_templates", "monitor" ],
  "indices" : [
      "names" : [ ".ent-search-*" ],
      "privileges" : [ "manage", "write", "read" ]
  • Ensure that there are no pre-existing Elasticsearch indexes with: .ent-search-*.
  • Dynamic Index Creation within Elasticsearch must be turned off for Enterprise Search indexes.

Ensure Elasticsearch is running:


If you can run curl http://localhost:9200/ to successfully reach Elasticsearch, then keep going!

Next, we must empower Elastic Enterprise Search or Elasticsearch to perform automatic index creation within Elasticsearch.

To do so, choose one of the following methods:

  1. Enterprise Search: Open config/enterprise-search.yml, add the line: allow_es_settings_modification: true

  2. Elasticsearch: Open elasticsearch.yml or within your Elasticsearch cluster settings, add the line: action.auto_create_index: ".ent-search-*-logs-*,-.ent-search-*,+*"

After that, enter the Enterprise Search directory and run...


Once running visit: http://localhost:3002.

The default login credentials are:

  • Email:

A password is generated for you on first boot.

You can also pass an environment variable with your own default password:

ENT_SEARCH_DEFAULT_PASSWORD=password bin/enterprise-search

It's important to note that during beta2, all your data is unencrypted by default.

A reminder that this is not fit for production usage -- be cautious when exposing the beta.

And with that, ready to get started?

Read the Getting Started guide.

Enjoying the beta? Something broken? Lost? Please send us your feedback or visit the Enterprise Search community.