Cannot restore index index because it cannot be upgraded – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 7.14-8.9

Briefly, this error occurs when you’re trying to restore an index from a snapshot that was created in an older version of Elasticsearch, which is not compatible with the current version. To resolve this issue, you can either upgrade the older version of Elasticsearch to match the current one before taking the snapshot, or create a new index with the current version and reindex the data from the old index. Alternatively, you can downgrade your current Elasticsearch version to match the one used when the snapshot was created.

This guide will help you check for common problems that cause the log ” cannot restore index [” + index + “] because it cannot be upgraded ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: restore, index.

Log Context

Log “cannot restore index [” + index + “] because it cannot be upgraded” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 snapshotIndexMetadata = convertLegacyIndex(snapshotIndexMetadata; currentState; indicesService);
 try {
 snapshotIndexMetadata = indexMetadataVerifier.verifyIndexMetadata(snapshotIndexMetadata; minIndexCompatibilityVersion);
 } catch (Exception ex) {
 throw new SnapshotRestoreException(snapshot; "cannot restore index [" + index + "] because it cannot be upgraded"; ex);
 final String renamedIndexName = indexEntry.getKey();
 final IndexMetadata currentIndexMetadata = currentState.metadata().index(renamedIndexName);
 final SnapshotRecoverySource recoverySource = new SnapshotRecoverySource(


How helpful was this guide?

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?