Installing Workplace Searchedit

Workplace 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 Troubleshooting & known issues for diagnostic help and known issues.

Supported platforms:edit

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

Minimum hardware:edit

  • ~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.


Running Workplace Searchedit

First, you’ll need to get Elasticsearch up and running with security features:

  1. Download Elasticsearch 7.6.x and enter the directory.
  2. Edit config/elasticsearch.yml and add: true

  1. Run the binary and start Elasticsearch:

$ bin/elasticsearch

  1. Generate a random password for the Elastic user:

$ bin/elasticsearch-setup-passwords auto

The second part is done within Workplace Search:

  1. Download and enter the directory.
  2. Edit config/enterprise-search.yml and add:
    ent_search.auth.source: standard
    elasticsearch.username: elastic
    elasticsearch.password: [ELASTIC_USER_PASSWORD]
    allow_es_settings_modification: true
  1. Specify a default password and start Workplace Search:

$ ENT_SEARCH_DEFAULT_PASSWORD=passwordexample bin/enterprise-search

The default username is enterprise_search.

Visit http://localhost:3002 and login using the password you’ve specified.

And that’s it! Enjoy.

Read the Getting started guide next!

Reminder: beta software is not fit for production usage.