[[installation]]
== Installation


[float]
Summary
~~~~~~~

There are a few ways to install curator. This document covers a few of them. If
you are trying to upgrade curator, please see <<upgrading>>.

[float]
Installation: Recommended
~~~~~~~~~~~~~~~~~~~~~~~~~

The recommended installation procedure utilizes
https://pip.pypa.io/en/latest/installing.html[python pip]:

---------------------------------
pip install elasticsearch-curator
---------------------------------

&nbsp;

[float]
PIP installation of a specific version:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you are still using Elasticsearch 0.90.x, you need to install curator
version 0.6.2:

----------------------------------------
pip install elasticsearch-curator==0.6.2
----------------------------------------

&nbsp;

Any other version-sepecific installation will follow this basic pattern.

[float]
Installation: PIP installation from source
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Download and install the https://github.com/shazow/urllib3[urllib3] dependency
(1.8.3 or greater):

. `wget https://pypi.python.org/packages/source/u/urllib3/urllib3-1.8.3.tar.gz`
. `pip install urllib3-1.8.3.tar.gz`

&nbsp;

Download and install the http://click.pocoo.org/[click] dependency (3.3 or
greater):

. `wget https://pypi.python.org/packages/source/c/click/click-3.3.tar.gz -O click-3.3.tar.gz`
. `pip install click-3.3.tar.gz`


&nbsp;

Download and install the https://github.com/elastic/elasticsearch-py[elasticsearch-py] dependency:

. `wget https://github.com/elastic/elasticsearch-py/archive/`+pass:attributes[{es_py_version}].tar.gz -O elasticsearch-py.tar.gz+
. `pip install elasticsearch-py.tar.gz`

&nbsp;

Download and install Curator:

. `wget https://github.com/elastic/curator/archive/v`+pass:attributes[{curator_version}].tar.gz -O elasticsearch-curator.tar.gz+
. `pip install elasticsearch-curator.tar.gz`
