This installation procedure utilizes python pip, and requires that the target machine has internet connectivity.

pip install elasticsearch-curator

If you plan on using Curator with AWS ES using IAM credentials, you must also install the requests_aws4auth python module:

pip install requests_aws4auth

Upgrading with pipedit

If you already have Elasticsearch Curator installed, and want to upgrade to the latest version, use the -U flag:

pip install -U elasticsearch-curator

Installing a specific version with pipedit

The -U flag uninstalls the current version (if any), then installs the latest version, or a specified one. Specify a specific version by adding == followed by the version you’d like to install, like this:

pip install -U elasticsearch-curator==X.Y.Z

System-wide vs. User-only installationedit

The above commands each imply a system-wide installation. This usually requires super-user access, or the sudo command. There is a way to install Curator into a path for just the current user, using the --user flag.

pip install --user elasticsearch-curator

This will result in the curator end-point being installed in the current user’s home directory, in the .local directory, in the bin subdirectory. The full path might look something like this:


You can make an alias or a symlink to this so you can call it more easily.

The --user flag can also be used in conjunction with the -U flag:

pip install -U --user elasticsearch-curator==X.Y.Z