IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

pip

edit

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 pip

edit

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 pip

edit

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 installation

edit

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:

/home/user/.local/bin/curator

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