1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
---
mapped_pages:
- https://www.elastic.co/guide/en/elasticsearch/client/curator/current/pip.html
sub:
curator_v: 8.0.18
---
# pip [pip]
This installation procedure requires a functional Python `pip` executable and requires that the target machine has internet connectivity for downloading Curator and the dependencies from [The Python Package Index](https://pypi.org).
```
pip install elasticsearch-curator
```
## Upgrading with pip [_upgrading_with_pip]
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 [_installing_a_specific_version_with_pip]
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
```
For example:
```
pip install -U elasticsearch-curator=={{curator_v}}
```
## System-wide vs. User-only installation [_system_wide_vs_user_only_installation]
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
```
|
