Refreshing repository UUID for repository – How to solve this Elasticsearch error

Opster Team

Aug-23, Version: 8.7-8.9

Briefly, this error occurs when Elasticsearch is trying to refresh the UUID (Universally Unique Identifier) for a specific repository. This could be due to a change in the repository or a synchronization issue. To resolve this, you can try to manually refresh the repository UUID. If the problem persists, check the repository settings and ensure they are correct. Also, ensure that the Elasticsearch cluster has the necessary permissions to access and modify the repository. Lastly, check for any network issues that might be causing synchronization problems.

This guide will help you check for common problems that cause the log ” refreshing repository UUID for repository [{}] ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: repository.

Log Context

Log “refreshing repository UUID for repository [{}]” classname is
We extracted the following from Elasticsearch source code for those seeking an in-depth context :

                // We only care about BlobStoreRepositories because they're the only ones that can contain a searchable snapshot; and we
                // only care about ones with missing UUIDs. It's possible to have the UUID change from under us if; e.g.; the repository was
                // wiped by an external force; but in this case any searchable snapshots are lost anyway so it doesn't really matter.
                if (repository instanceof BlobStoreRepository && repository.getMetadata().uuid().equals(RepositoryData.MISSING_UUID)) {
                    final var repositoryName = repository.getMetadata().name();
          "refreshing repository UUID for repository [{}]"; repositoryName);
                    repository.getRepositoryData(ActionListener.releaseAfter(new ActionListener() {
                        public void onResponse(RepositoryData repositoryData) {
                            logger.debug(() -> format("repository UUID [{}] refresh completed"; repositoryName));


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?