Command-line client for Elasticsearch

This project provides a command line tool to query ElasticSearch clusters.


elasticsearch-cli can be installed with opam:

opam install elasticsearch-cli

Getting help

Show known commands

es --help

or just


Show man page for a command

es <command> --help

for example:

es search --help

Configuration file

The tool will look for a configuration file $XDG_HOME_CONFIG/es-cli/config.json when started
($XDG_HOME_CONFIG will be usually ~/.config; see XDG Base Directory Specification for more details).

Cluster aliases

It is possible to use alias names instead of full host names.

  "clusters": {
    "cluster1": {
      "host": "http://cluster1.mydomain.com:9200"
    "cluster2": {
      "host": "http://cluster2.mydomain.com:9200",
      "nodes": [

show health for cluster1.mydomain.com

es health cluster1

show health for all configured clusters

es health

search in cluster2.mydomain.com

es search cluster2 myindex

find missing nodes in cluster2

es nodes cluster2

Note this command relies on the nodes parameter in the configuration file.

Command aliases

  "aliases": {
    "pause": {
      "command": "settings",
      "args": [ "-p", "cluster.routing.allocation.enable=none" ]
    "resume": {
      "command": "settings",
      "args": [ "-p", "cluster.routing.allocation.enable=all" ]

Pause shard allocation

es pause cluster1

Resume shard allocation

es resume cluster1

Search documents

Search the index myindex for documents containing "Hello world!" in the title field. Return fields
field1 and field2 of the document with the most recent value of the updated_at field:

es search cluster1.mydomain.com:9200 myindex -i field1,field2 -s updated_at:desc -n 1 -q 'title:"Hello world!"'

Search the index myindex for documents containing 12345 in the field1 field. Return 10 documents' sources,
omitting the boringfield field.

es search cluster1.mydomain.com:9200 myindex -e boringfield -n 10 -f source '{"query":{"term":{"field1":12345}}}'

Show the number of documents in the index myindex with field field1 value greater or equal to 10:

es search cluster1.mydomain.com:9200 myindex -n 0 -c -q 'field1:>=10'

NOTE: ES 7.x and above will not return exact document count by default. Use -c -C true to print the exact value.

Count documents

Count documents containing "Hello world!" in the title field in the index myindex.

es count cluster1.mydomain.com:9200 myindex -q 'title:"Hello world!"'

Add or remove index alias

Add alias alias1 to myindex1 and alias alias2 to myindex2:

es alias cluster1.mydomain.com:9200 -a alias1=myindex1 -a alias2=myindex2

Remove alias alias1 from myindex1 and alias alias2 from myindex2:

es alias cluster1.mydomain.com:9200 -r alias1=myindex1 -r alias2=myindex2

Move index alias current from index-3 to index-4

es alias cluster1.mydomain.com:9200 -r current=index-3 -a current=index-4

Remove alias alias1 and add alias alias2 to index.

es alias cluster1.mydomain.com:9200 index -r alias1 -a alias2

Get document(s) by id

es get cluster1.mydomain.com:9200 myindex docid


es get cluster1.mydomain.com:9200 myindex docid1 docid2 docid3

Put document with or without id

es put cluster1.mydomain.com:9200 myindex docid '{ "first_name": "John", "last_name": "Doe" }'
es put cluster1.mydomain.com:9200 myindex '{ "first_name": "Jane", "last_name": "Doe" }'
echo '{ "first_name": "Johnny", "last_name": "Doe" }' | es put cluster1.mydomain.com:9200 myindex docid2

Delete documents by id

es delete cluster1.mydomain.com:9200 myindex docid1 docid2


es refresh cluster1.mydomain.com:9200 myindex1 myindex2


es flush cluster1.mydomain.com:9200 myindex1 myindex2

Use -f to force flush, -s to issue a synced flush, and -w to wait for an already ongoing flush.

Check health of multiple clusters

es health cluster1.mydomain.com:9200 cluster2.mydomain.com:9200

Check nodes of a cluster

Expect data0...data9, client0...client4 and master nodes to be present):

es nodes cluster1.mydomain.com:9200 -h data{0..9} master client{0..4}

Expect all nodes listed for cluster mycluster in the configuration file to be present:

es nodes mycluster

Check shard recovery status

Display shards which are not in DONE stage:

es recovery cluster1.mydomain.com:9200 -e stage done

Get or set cluster setttings

List all persistent and transient settings:

es settings cluster1.mydomain.com:9200

List all settings, including default ones:

es settings cluster1.mydomain.com:9200 -D

Use -p, -t or -d to operate only on persistent, transient or default settings, respectively.

Update a persistent cluster setting:

es settings cluster1.mydomain.com:9200 -p cluster.routing.allocation.enable=none
02 Oct 2020
>= "v0.9.0"
>= "3.2.0"
>= "1.7.1"
>= "1.0"
>= "1.6.0" & < "2.3.0"
>= "1.5"
>= "4.01.0"
Reverse Dependencies