# Elasticsearch Curator

The Elasticsearch Curator helps you manage your indices and snapshots.

Note

This documentation is for Elasticsearch Curator. Documentation specifically for use of the command-line interface – which uses this API and is installed as an `entry_point` as part of the package – is available in the Elastic guide.

## Contents

- About
  - Examples
  - Using Curator
  - Testing
  - Contributing
  - Changelog
- Using Curator
  - Compatibility
  - Installation
  - Command-Line Usage
  - Example API Usage
  - Logging
- API and Code Reference
  - Actions
  - Index List
  - Snapshot List
  - Other Class Definitions
  - Helpers
  - Validators
  - Defaults
  - Exceptions
  - Other Modules
- Testing
  - Setup Testing
  - Running Tests
- Examples
  - Filter indices by prefix
  - Filter indices by suffix
  - Filter indices by age (name)
  - Filter indices by age (creation_date)
  - Filter indices by age (field_stats)
- Changelog
  - [9.0.0] - 2025-10-03
  - 8.0.21 (1 April 2025)
  - 8.0.20 (21 March 2025)
  - 8.0.19 (5 March 2025)
  - 8.0.18 (27 February 2025)
  - 8.0.17 (25 October 2024)
  - 8.0.16 (6 August 2024)
  - 8.0.15 (10 April 2024)
  - 8.0.14 (2 April 2024)
  - 8.0.13 (26 March 2024)
  - 8.0.12 (20 March 2024)
  - 8.0.11 (20 March 2024)
  - 8.0.10 (1 February 2024)
  - 8.0.9 (31 January 2024)
  - 8.0.8 (21 July 2023)
  - 8.0.7 (21 July 2023)
  - 8.0.6.post1 (18 July 2023)
  - 8.0.6 (18 July 2023)
  - 8.0.5 (13 July 2023)
  - 8.0.4 (28 April 2023)
  - 8.0.3 (22 February 2023)
  - 8.0.2 (15 February 2023)
  - 8.0.1 (10 February 2023)
  - 8.0.0 (31 January 2023)
  - 8.0.0rc1 (30 January 2023)
  - 8.0.0a1 (26 January 2023)
  - 7.0.0 (31 January 2023)
  - 6.0.0 (31 January 2023)
  - 5.8.4 (27 April 2021)
  - 5.8.3 (25 November 2020)
  - 5.8.2 (24 November 2020)
  - 5.8.1 (25 September 2019)
  - 5.8.0 (24 September 2019)
  - 5.7.6 (6 May 2019)
  - 5.7.5 (26 April 2019)
  - 5.7.4 (25 April 2019)
  - 5.7.3 (24 April 2019)
  - 5.7.2 (24 April 2019)
  - 5.7.1 (24 April 2019)
  - 5.7.0 (24 April 2019)
  - 5.6.0 (13 November 2018)
  - 5.5.4 (23 May 2018)
  - 5.5.3 (21 May 2018)
  - 5.5.2 (14 May 2018)
  - 5.5.1 (22 March 2018)
  - 5.5.0 (21 March 2018)
  - 5.4.1 (6 December 2017)
  - 5.4.0 (13 November 2017)
  - 5.3.0 (31 October 2017)
  - 5.2.0 (1 September 2017)
  - 5.1.2 (08 August 2017)
  - 5.1.1 (8 June 2017)
  - 5.1.0 (8 June 2017)
  - 5.0.4 (16 May 2017)
  - 5.0.3 (15 May 2017)
  - 5.0.2 (4 May 2017)
  - 5.0.1 (10 April 2017)
  - 5.0.0 (5 April 2017)
  - 5.0.0a1 (23 March 2017)
  - 4.2.6 (27 January 2016)
  - 4.2.5 (22 December 2016)
  - 4.2.4 (7 December 2016)
  - 4.2.3.post1 (22 November 2016)
  - 4.2.3 (21 November 2016)
  - 4.2.2 (21 November 2016)
  - 4.2.1 (8 November 2016)
  - 4.2.0 (4 November 2016)
  - 4.1.2 (6 October 2016)
  - 4.1.1 (27 September 2016)
  - 4.1.0 (6 September 2016)
  - 4.0.6 (15 August 2016)
  - 4.0.5 (3 August 2016)
  - 4.0.4 (1 August 2016)
  - 4.0.3 (22 July 2016)
  - 4.0.2 (22 July 2016)
  - 4.0.1 (1 July 2016)
  - 4.0.0 (24 June 2016)
  - 4.0.0b2 (16 June 2016)
  - 4.0.0b1 (13 June 2016)
  - 4.0.0a10 (10 June 2016)
  - 4.0.0a9 (27 Apr 2016)
  - 4.0.0a8 (26 Apr 2016)
  - 4.0.0a7 (25 Apr 2016)
  - 4.0.0a6 (25 Apr 2016)
  - 4.0.0a4 (21 Apr 2016)
  - 4.0.0a3 (21 Apr 2016)
  - 3.5.1 (21 March 2016)
  - 3.5.0 (16 March 2016)
  - 3.4.1 (10 February 2016)
  - 3.4.0 (28 October 2015)
  - 3.3.0 (31 August 2015)
  - 3.2.3 (16 July 2015)
  - 3.2.2 (13 July 2015)
  - 3.2.1 (10 July 2015)
  - 3.2.0 (25 June 2015)
  - 3.1.0 (21 May 2015)
  - 3.0.3 (27 Mar 2015)
  - 3.0.2 (23 Mar 2015)
  - 3.0.1 (16 Mar 2015)
  - 3.0.0 (9 March 2015)
  - 3.0.0rc1 (5 March 2015)
  - 3.0.0b4 (5 March 2015)
  - 3.0.0b3 (4 March 2015)
  - 3.0.0-beta2 (3 March 2015)
  - 3.0.0-beta1 (3 March 2015)
  - 2.1.2 (22 January 2015)
  - 2.1.1 (30 December 2014)
  - 2.1.0 (30 December 2014)
  - 2.0.2 (8 October 2014)
  - 2.0.1 (1 October 2014)
  - 2.0.0 (25 September 2014)
  - 1.2.2 (29 July 2014)
  - 1.2.1 (24 July 2014)
  - 1.2.0 (24 July 2014)
  - 1.1.3 (18 July 2014)
  - 1.1.2 (13 June 2014)
  - 1.1.0 (12 June 2014)
  - 1.0.0 (25 Mar 2014)
  - 0.6.2 (18 Feb 2014)
  - 0.6.1 (08 Feb 2014)
  - 0.6.0 (08 Feb 2014)
  - 0.5.2 (26 Jan 2014)
  - 0.5.1 (20 Jan 2014)
  - 0.5.0 (17 Jan 2014)
  - 0.4.0
- Index

## License

Copyright (c) 2011–2025 Elasticsearch <http://www.elastic.co>

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

> http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

## Indices and Tables

- Index

- Search Page