Upgrade Elasticsearchedit

Elasticsearch can usually be upgraded using a Rolling upgrade process so upgrading does not interrupt service. Rolling upgrades are supported:

  • Between minor versions
  • From 5.6 to 6.8
  • From 6.8 to 7.x
  • From 7.x to 8.0.0

The following table shows the recommended upgrade paths to 8.0.0.

Upgrade fromRecommended upgrade path to 8.0.0


Rolling upgrade to 8.0.0





The following upgrade paths are not supported:

  • 6.8 to 7.0.
  • 6.7 to 7.1.–7.x.

Elasticsearch can read indices created in the previous major version. If you have indices created in 5.x or before, you must reindex or delete them before upgrading to 8.0.0. Elasticsearch nodes will fail to start if incompatible indices are present. Snapshots of 5.x or earlier indices cannot be restored to a 7.x cluster even if they were created by a 6.x cluster. For information about upgrading old indices, see Reindex to upgrade.

When upgrading to a new version of Elasticsearch, you need to upgrade each of the products in your Elastic Stack. For more information, see the Elastic Stack Installation and Upgrade Guide.

To upgrade directly to 8.0.0 from 6.6 or earlier, you must shut down the cluster, install 8.0.0, and restart. For more information, see Full cluster restart upgrade.

Preparing to upgradeedit

Before upgrading Elasticsearch:

  1. Check the deprecation log to see if you are using any deprecated features and update your code accordingly. By default, deprecation warnings are logged when the log level is set to WARN.
  2. Review the breaking changes and make any necessary changes to your code and configuration for 8.0.0.
  3. If you use custom plugins, make sure compatible versions are available.
  4. Test upgrades in a dev environment before upgrading your production cluster.
  5. Back up your data! You must have a snapshot of your data to roll back to an earlier version.